WHvCreateVirtualProcessor2

Tworzy nowy procesor wirtualny w partycji z opcjonalnymi właściwościami czasu tworzenia.

Składnia

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

Dojście do obiektu partycji.

VpIndex

Określa indeks nowego procesora wirtualnego.

Properties

Określa tablicę właściwości, które mają być stosowane do nowego procesora wirtualnego w czasie tworzenia. Może być NULL wtedy, gdy PropertyCount jest zero.

PropertyCount

Określa liczbę elementów w tablicy Properties . Gdy zero, procesor wirtualny jest tworzony z domyślnymi właściwościami.

Properties

Każdy element tablicy jest elementemWHV_VIRTUAL_PROCESSOR_PROPERTY, którego PropertyCode element Properties członkowski wybiera właściwość do zastosowania i którego element członkowski wartości dostarcza ustawienie. Jeśli ten sam kod właściwości pojawia się więcej niż raz, ostatnia podana wartość zostanie wprowadzona. Zdefiniowane są następujące kody właściwości.

WHvVirtualProcessorPropertyCodeNumaNode

Określa węzeł NUMA, który wspiera procesor wirtualny w elemencie NumaNode członkowskim. Jeśli ta właściwość nie jest dostarczana, procesor wirtualny jest umieszczany w idealnym węźle NUMA wątku wywołującego.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość to S_OK.

Jeśli procesor wirtualny już istnieje w parametrze VpIndex, zwracana wartość to WHV_E_VP_ALREADY_EXISTS. Jeśli VpIndex wartość jest większa lub równa liczbie procesorów partycji, jeśli właściwość określa nieznany kod właściwości lub jeśli NumaNode wartość nie jest prawidłowym węzłem NUMA, zwracana wartość to E_INVALIDARG.

Remarks

Funkcja WHvCreateVirtualProcessor2 tworzy nowy procesor wirtualny w partycji. W systemie x64 indeks procesora wirtualnego jest używany do ustawiania identyfikatora APIC procesora. Wywołanie WHvCreateVirtualProcessor(Partition, VpIndex, 0) jest równoważne wywołaniu WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Requirements

Requirement Value
Minimalna obsługiwana Windows Windows 10, wersja 20H2 (x64); Windows 11, wersja 24H2, kompilacja 26100.3915 (Arm64)
Header WinHvPlatform.h
Biblioteka WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Zobacz także

  • Last updated on