WHvCreateVirtualProcessor2

Crée un processeur virtuel dans une partition avec des propriétés de création facultatives.

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
    );

Paramètres

Partition

Gérer l’objet de partition.

VpIndex

Spécifie l’index du nouveau processeur virtuel.

Properties

Spécifie un tableau de propriétés à appliquer au nouveau processeur virtuel au moment de la création. Peut être NULL quand est PropertyCount égal à zéro.

PropertyCount

Spécifie le nombre d’éléments dans le Properties tableau. Quand zéro, le processeur virtuel est créé avec les propriétés par défaut.

Propriétés

Chaque élément du Properties tableau est un WHV_VIRTUAL_PROCESSOR_PROPERTY membre dont PropertyCode le membre sélectionne la propriété à appliquer et dont le membre valeur fournit le paramètre. Si le même code de propriété apparaît plusieurs fois, la dernière valeur fournie prend effet. Les codes de propriété suivants sont définis.

WHvVirtualProcessorPropertyCodeNumaNode

Spécifie le nœud NUMA qui sauvegarde le processeur virtuel, dans le NumaNode membre. Lorsque cette propriété n’est pas fournie, le processeur virtuel est placé sur le nœud NUMA idéal du thread appelant.

Valeur de retour

Si la fonction réussit, la valeur de retour est S_OK.

Si un processeur virtuel existe déjà à VpIndex, la valeur de retour est WHV_E_VP_ALREADY_EXISTS. Si VpIndex elle est supérieure ou égale au nombre de processeurs de la partition, si une propriété spécifie un code de propriété inconnu ou si la NumaNode valeur n’est pas un nœud NUMA valide, la valeur de retour est E_INVALIDARG.

Remarks

La WHvCreateVirtualProcessor2 fonction crée un processeur virtuel dans une partition. Sur x64, l’index du processeur virtuel est utilisé pour définir l’ID APIC du processeur. Appeler WHvCreateVirtualProcessor(Partition, VpIndex, 0) équivaut à appeler WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Exigences

Voir aussi

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Noms et valeurs du registre de processeur virtuel
• Windows définitions d’API de plateforme Hyperviseur