WHvCreateVirtualProcessor2

Vytvoří nový virtuální procesor v oddílu s volitelnými vlastnostmi času vytvoření.

Syntaxe

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

Popisovač objektu oddílu

VpIndex

Určuje index nového virtuálního procesoru.

Properties

Určuje pole vlastností, které se použijí na nový virtuální procesor při vytváření. Může to být NULL , když PropertyCount je nula.

PropertyCount

Určuje počet prvků v Properties poli. Když je nula, vytvoří se virtuální procesor s výchozími vlastnostmi.

Properties

Každý prvek Properties pole je WHV_VIRTUAL_PROCESSOR_PROPERTY , jehož PropertyCode člen vybere vlastnost, která se má použít a jejíž hodnota člen poskytuje nastavení. Pokud se stejný kód vlastnosti zobrazí více než jednou, projeví se poslední zadaná hodnota. Jsou definovány následující kódy vlastností.

WHvVirtualProcessorPropertyCodeNumaNode

Určuje uzel NUMA, který v členu NumaNode zálohuje virtuální procesor. Pokud tato vlastnost není zadána, virtuální procesor se umístí na ideální uzel NUMA volajícího vlákna.

Návratová hodnota

Pokud je funkce úspěšná, návratová hodnota je S_OK.

Pokud již virtuální procesor existuje VpIndex, návratová hodnota je WHV_E_VP_ALREADY_EXISTS. Pokud VpIndex je větší nebo rovna počtu procesorů oddílu, pokud vlastnost určuje neznámý kód vlastnosti nebo pokud NumaNode hodnota není platným uzlem NUMA, je vrácená hodnota E_INVALIDARG.

Remarks

Funkce WHvCreateVirtualProcessor2 vytvoří nový virtuální procesor v oddílu. Na platformě x64 se index virtuálního procesoru používá k nastavení ID APIC procesoru. Volání WHvCreateVirtualProcessor(Partition, VpIndex, 0) je ekvivalentní volání WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Požadavky

Viz také

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Názvy a hodnoty registru virtuálních procesorů
• Windows definice rozhraní API platformy Hypervisor