WHvCreateVirtualProcessor2

Crea un nuevo procesador virtual en una partición con propiedades opcionales en tiempo de creación.

Syntax

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

Identificador del objeto de partición.

VpIndex

Especifica el índice del nuevo procesador virtual.

Properties

Especifica una matriz de propiedades que se aplicarán al nuevo procesador virtual en el momento de la creación. Puede ser NULL cuando PropertyCount es cero.

PropertyCount

Especifica el número de elementos de la Properties matriz. Cuando es cero, el procesador virtual se crea con las propiedades predeterminadas.

Propiedades

Cada elemento de la Properties matriz es un WHV_VIRTUAL_PROCESSOR_PROPERTY cuyo PropertyCode miembro selecciona la propiedad que se va a aplicar y cuyo miembro de valor proporciona la configuración. Si el mismo código de propiedad aparece más de una vez, el último valor proporcionado surte efecto. Se definen los siguientes códigos de propiedad.

WHvVirtualProcessorPropertyCodeNumaNode

Especifica el nodo NUMA que respalda el procesador virtual, en el NumaNode miembro . Cuando no se proporciona esta propiedad, el procesador virtual se coloca en el nodo NUMA ideal del subproceso que realiza la llamada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es S_OK.

Si ya existe un procesador virtual en VpIndex, el valor devuelto es WHV_E_VP_ALREADY_EXISTS. Si VpIndex es mayor o igual que el recuento de procesadores de la partición, si una propiedad especifica un código de propiedad desconocido o si el NumaNode valor no es un nodo NUMA válido, el valor devuelto es E_INVALIDARG.

Remarks

La WHvCreateVirtualProcessor2 función crea un nuevo procesador virtual en una partición. En x64, el índice del procesador virtual se usa para establecer el identificador APIC del procesador. Llamar a WHvCreateVirtualProcessor(Partition, VpIndex, 0) es equivalente a llamar a WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Requisitos

Consulte también

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Nombres y valores de registro del procesador virtual
• Windows Definiciones de API de la plataforma hipervisor