WHvCreateVirtualProcessor2

Hiermee maakt u een nieuwe virtuele processor in een partitie met optionele eigenschappen voor het maken van tijd.

Syntaxis

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

Greep naar het partitieobject.

VpIndex

Hiermee geeft u de index van de nieuwe virtuele processor.

Properties

Hiermee geeft u een matrix van eigenschappen die op de nieuwe virtuele processor moeten worden toegepast tijdens het maken. Kan zijn NULL wanneer PropertyCount is nul.

PropertyCount

Hiermee geeft u het aantal elementen in de Properties matrix. Wanneer nul wordt de virtuele processor gemaakt met standaardeigenschappen.

Properties

Elk element van de Properties matrix is een WHV_VIRTUAL_PROCESSOR_PROPERTY lid waarvan PropertyCode de eigenschap wordt geselecteerd die moet worden toegepast en waarvan het waardelid de instelling levert. Als dezelfde eigenschapscode meerdere keren wordt weergegeven, wordt de laatste opgegeven waarde van kracht. De volgende eigenschapscodes worden gedefinieerd.

WHvVirtualProcessorPropertyCodeNumaNode

Hiermee geeft u het NUMA-knooppunt op dat de virtuele processor terugstuurt, in het NumaNode lid. Wanneer deze eigenschap niet wordt opgegeven, wordt de virtuele processor geplaatst op het ideale NUMA-knooppunt van de aanroepende thread.

Retourwaarde

Als de functie slaagt, is S_OKde retourwaarde .

Als er al een virtuele processor bestaat VpIndexop, is WHV_E_VP_ALREADY_EXISTSde retourwaarde . Als VpIndex deze groter is dan of gelijk is aan het processoraantal van de partitie, als een eigenschap een onbekende eigenschapscode opgeeft of als de NumaNode waarde geen geldig NUMA-knooppunt is, is E_INVALIDARGde retourwaarde.

Remarks

De WHvCreateVirtualProcessor2 functie maakt een nieuwe virtuele processor in een partitie. Op x64 wordt de index van de virtuele processor gebruikt om de APIC-id van de processor in te stellen. Bellen WHvCreateVirtualProcessor(Partition, VpIndex, 0) is gelijk aan bellen WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Vereisten

Zie ook

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Namen en waarden van virtuele processor registreren
• Windows API-definities voor hypervisorplatforms