WHvSetVirtualProcessorInterruptControllerState2

Define o estado APIC local de um processador virtual.

Importante

WHvSetVirtualProcessorInterruptControllerState2 está obsoleto. Use WHvSetVirtualProcessorState com o WHvVirtualProcessorStateTypeInterruptControllerState2 tipo de estado em vez disso.

Note

Essa função se aplica somente a partições x64.

Sintaxe

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

Parameters

Partition

Manipule para o objeto de partição.

VpIndex

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

State

Especifica o estado do controlador de interrupção a ser aplicado, no formato de estado externo padrão.

StateSize

Especifica o tamanho de State, em bytes.

Valor de retorno

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

Se State for NULL, ou se StateSize for menor que o tamanho do estado necessário, o valor retornado será E_POINTER. 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 WHvSetVirtualProcessorInterruptControllerState2 função restaura o estado APIC local do processador virtual especificado de um buffer no formato de estado externo padrão, normalmente um produzido anteriormente por WHvGetVirtualProcessorInterruptControllerState2. Como o TPR (registro de prioridade de tarefa) não faz parte do estado do controlador de interrupção do hipervisor, a função também sincroniza o registro do CR8 processador virtual quando o TPR fornecido difere do valor atual.

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

Requisitos

Requirement Value
Suporte mínimo Windows Windows 10, versão 2004
Header WinHvPlatform.h
Biblioteca WinHvPlatform.lib
DLL WinHvPlatform.dll
Arquitetura x64

Consulte também