WHvCreateVirtualProcessor2

Létrehoz egy új virtuális processzort egy partíción, opcionális létrehozási idő tulajdonságokkal.

Szemantika

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

A partícióobjektum kezelése.

VpIndex

Az új virtuális processzor indexét adja meg.

Properties

Az új virtuális processzorra a létrehozáskor alkalmazandó tulajdonságok tömbje. Lehet, NULL hogy PropertyCount nulla.

PropertyCount

A tömb elemeinek Properties számát adja meg. Ha nulla, a virtuális processzor alapértelmezett tulajdonságokkal jön létre.

Properties

A tömb minden eleme Properties egy WHV_VIRTUAL_PROCESSOR_PROPERTY olyan tag, amelynek PropertyCode tagja kiválasztja az alkalmazandó tulajdonságot, és amelynek az értéktagja adja meg a beállítást. Ha ugyanaz a tulajdonságkód többször is megjelenik, az utolsó megadott érték érvénybe lép. A következő tulajdonságkódok vannak definiálva.

WHvVirtualProcessorPropertyCodeNumaNode

Megadja a virtuális processzort a tagban a virtuális processzort háttérbe váltó NUMA-csomópontot NumaNode . Ha ez a tulajdonság nincs megadva, a virtuális processzor a hívószál ideális NUMA-csomópontjára kerül.

Visszaadott érték

Ha a függvény sikeres, a visszatérési érték az S_OK.

Ha már létezik VpIndexvirtuális processzor, a visszatérési érték a következő WHV_E_VP_ALREADY_EXISTS: . Ha VpIndex nagyobb vagy egyenlő a partíció processzorszámával, ha egy tulajdonság ismeretlen tulajdonságkódot ad meg, vagy ha az NumaNode érték nem érvényes NUMA-csomópont, akkor a visszatérési érték .E_INVALIDARG

Remarks

A WHvCreateVirtualProcessor2 függvény létrehoz egy új virtuális processzort egy partíción. X64 esetén a virtuális processzor indexe a processzor APIC-azonosítójának beállítására szolgál. A hívás WHvCreateVirtualProcessor(Partition, VpIndex, 0) egyenértékű a hívással WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Requirements

Lásd még

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Virtuális processzor – nevek és értékek regisztrálása
• Windows Hipervizor platform API-definíciói