WHvSetVirtualProcessorInterruptControllerState2

Define o estado APIC local de um processador virtual.

Sintaxe

HRESULT
WINAPI
WHvSetVirtualProcessorInterruptControllerState2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_reads_bytes_(StateSize) const VOID* State,
    _In_ UINT32 StateSize
    );

Parameters

Partition

Handle para o objeto de partição.

VpIndex

Especifica o índice do processador virtual cujo estado do controlador de interrupções está definido.

State

Especifica o estado do controlador de interrupções a aplicar, no formato padrão de estado externo.

StateSize

Especifica o tamanho de State, em bytes.

Valor de retorno

Se a função tiver sucesso, o valor de retorno é S_OK.

Se State for NULL, ou se StateSize for menor do que o tamanho do estado requerido, o valor de retorno é E_POINTER. Se VpIndex não identificar um processador virtual existente, o valor de retorno é WHV_E_VP_DOES_NOT_EXIST. Se o processador virtual não puder ser acedido no seu estado atual, o valor de retorno é WHV_E_INVALID_VP_STATE.

Remarks

A WHvSetVirtualProcessorInterruptControllerState2 função restaura o estado APIC local do processador virtual especificado a partir de um buffer no formato de estado externo padrão, tipicamente um anteriormente produzido por WHvGetVirtualProcessorInterruptControllerState2. Como o registo de prioridade de tarefa (TPR) não faz parte do estado do controlador de interrupções do hipervisor, a função também sincroniza o registo do CR8 processador virtual quando o TPR fornecido difere do valor atual.

A função requer a emulação do APIC local para ser configurada para a partição.

Requirements

Ver também

• WHvGetVirtualProcessorInterruptControllerState2
• WHvSetVirtualProcessorInterruptControllerState
• WHvSetVirtualProcessorState
• Windows Definições da API da Plataforma de Hipervisores