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

Manipule para o objeto de partição.

VpIndex

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

State

Recebe o estado do controlador de interrupção.

StateSize

Especifica o tamanho de State, em bytes.

WrittenSize

Se não for NULL, receberá o número de bytes gravados em State. Quando o buffer é muito pequeno, ele recebe o número de bytes necessários.

Valor de retorno

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

Se State for muito pequeno para conter o estado do controlador de interrupção, o valor retornado será WHV_E_INSUFFICIENT_BUFFERe WrittenSize receberá o número de bytes necessários. Se VpIndex não identificar um processador virtual existente, o valor retornado será WHV_E_VP_DOES_NOT_EXIST. Se o processador virtual não puder ser acessado em seu estado atual, o valor retornado será WHV_E_INVALID_VP_STATE.

Remarks

A WHvGetVirtualProcessorInterruptControllerState2 função recupera o estado APIC local do processador virtual especificado no formato de estado externo padrão. Ele substitui os vetores preteridos, que retorna um formato herdado WHvGetVirtualProcessorInterruptControllerStateque empacota os vetores de solicitação de interrupção, em serviço e de modo de gatilho de forma diferente do formato de estado externo padrão e não inclui o registro de prioridade do processador.

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

Requisitos

Consulte também

• WHvSetVirtualProcessorInterruptControllerState2
• WHvGetVirtualProcessorInterruptControllerState
• WHvGetVirtualProcessorState
• definições de API da Plataforma do Hipervisor Windows