WHvGetVirtualProcessorInterruptControllerState2

Recupera o estado APIC local de um processador virtual.

Sintaxe

HRESULT
WINAPI
WHvGetVirtualProcessorInterruptControllerState2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _Out_writes_bytes_to_(StateSize, *WrittenSize) VOID* State,
    _In_ UINT32 StateSize,
    _Out_opt_ UINT32* WrittenSize
    );

Parameters

Partition

Handle para o objeto de partição.

VpIndex

Especifica o índice do processador virtual cujo estado do controlador de interrupções é recuperado.

State

Recebe o estado do controlador de interrupções.

StateSize

Especifica o tamanho de State, em bytes.

WrittenSize

Se não for NULL, recebe o número de bytes escritos em State. Quando o buffer é demasiado pequeno, recebe o número de bytes necessários.

Valor de retorno

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

Se State for demasiado pequeno para conter o estado do controlador de interrupções, o valor de retorno é WHV_E_INSUFFICIENT_BUFFER, e WrittenSize recebe o número de bytes necessários. 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 WHvGetVirtualProcessorInterruptControllerState2 função recupera o estado APIC local do processador virtual especificado no formato padrão de estado externo. Substitui o obsoleto WHvGetVirtualProcessorInterruptControllerState, que devolve um formato legado que empacota os vetores de pedido de interrupção, em serviço e modo de disparo de forma diferente do formato padrão de estado externo e não inclui o registo de prioridade do processador.

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

Requirements

Ver também

• WHvSetVirtualProcessorInterruptControllerState2
• WHvGetVirtualProcessorInterruptControllerState
• WHvGetVirtualProcessorState
• Windows Definições da API da Plataforma de Hipervisores