WHvCreateVirtualProcessor2

Membuat prosesor virtual baru dalam partisi dengan properti waktu pembuatan opsional.

Syntax

typedef enum WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE
{
    WHvVirtualProcessorPropertyCodeNumaNode = 0x00000000,
} WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE;

typedef struct WHV_VIRTUAL_PROCESSOR_PROPERTY
{
    WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE PropertyCode;
    UINT32 Reserved;
    union
    {
        USHORT NumaNode;
        UINT64 Padding;
    };
} WHV_VIRTUAL_PROCESSOR_PROPERTY;

HRESULT
WINAPI
WHvCreateVirtualProcessor2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_reads_(PropertyCount) const WHV_VIRTUAL_PROCESSOR_PROPERTY* Properties,
    _In_ UINT32 PropertyCount
    );

Parameters

Partition

Tangani ke objek partisi.

VpIndex

Menentukan indeks prosesor virtual baru.

Properties

Menentukan array properti untuk diterapkan ke prosesor virtual baru pada waktu pembuatan. Mungkin NULL ketika PropertyCount nol.

PropertyCount

Menentukan jumlah elemen dalam Properties array. Ketika nol, prosesor virtual dibuat dengan properti default.

Properties

Setiap elemen Properties array adalah WHV_VIRTUAL_PROCESSOR_PROPERTY yang anggotanya PropertyCode memilih properti untuk diterapkan dan anggota nilainya menyediakan pengaturan. Jika kode properti yang sama muncul lebih dari sekali, nilai terakhir yang disediakan akan berlaku. Kode properti berikut didefinisikan.

WHvVirtualProcessorPropertyCodeNumaNode

Menentukan simpul NUMA yang mendukung prosesor virtual, dalam NumaNode anggota. Ketika properti ini tidak disediakan, prosesor virtual ditempatkan pada simpul NUMA yang ideal dari utas panggilan.

Mengembalikan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

Jika prosesor virtual sudah ada di VpIndex, nilai yang dikembalikan adalah WHV_E_VP_ALREADY_EXISTS. Jika VpIndex lebih besar dari atau sama dengan jumlah prosesor partisi, jika properti menentukan kode properti yang tidak diketahui, atau jika NumaNode nilainya bukan simpul NUMA yang valid, nilai yang dikembalikan adalah E_INVALIDARG.

Remarks

Fungsi ini WHvCreateVirtualProcessor2 membuat prosesor virtual baru dalam partisi. Pada x64, indeks prosesor virtual digunakan untuk mengatur ID APIC prosesor. Panggilan WHvCreateVirtualProcessor(Partition, VpIndex, 0) setara dengan panggilan WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Requirements

Baca juga

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Nama dan Nilai Pendaftaran Prosesor Virtual
• Definisi API Platform Hypervisor Windows