WHvCreateVirtualProcessor2

Cria um novo processador virtual em uma partição com propriedades opcionais de tempo de criação.

Sintaxe

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

Manipule para o objeto de partição.

VpIndex

Especifica o índice do novo processador virtual.

Properties

Especifica uma matriz de propriedades a serem aplicadas ao novo processador virtual no momento da criação. Pode ser NULL quando PropertyCount é zero.

PropertyCount

Especifica o número de elementos na Properties matriz. Quando zero, o processador virtual é criado com propriedades padrão.

Propriedades

Cada elemento da Properties matriz é um WHV_VIRTUAL_PROCESSOR_PROPERTY cujo PropertyCode membro seleciona a propriedade a ser aplicada e cujo membro de valor fornece a configuração. Se o mesmo código de propriedade aparecer mais de uma vez, o último valor fornecido entrará em vigor. Os códigos de propriedade a seguir são definidos.

WHvVirtualProcessorPropertyCodeNumaNode

Especifica o nó NUMA que apoia o processador virtual no NumaNode membro. Quando essa propriedade não é fornecida, o processador virtual é colocado no nó NUMA ideal do thread de chamada.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será S_OK.

Se um processador virtual já existir, VpIndexo valor retornado será WHV_E_VP_ALREADY_EXISTS. Se VpIndex for maior ou igual à contagem de processadores da partição, se uma propriedade especificar um código de propriedade desconhecido ou se o NumaNode valor não for um nó NUMA válido, o valor retornado será E_INVALIDARG.

Remarks

A WHvCreateVirtualProcessor2 função cria um novo processador virtual em uma partição. No x64, o índice do processador virtual é usado para definir a ID APIC do processador. Chamar WHvCreateVirtualProcessor(Partition, VpIndex, 0) é equivalente a chamar WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0).

Requisitos

Consulte também

• WHvCreateVirtualProcessor
• WHvDeleteVirtualProcessor
• Nomes e valores de registro do processador virtual
• definições de API da Plataforma do Hipervisor Windows