WHvSetVirtualProcessorInterruptControllerState2

Establece el estado APIC local de un procesador virtual.

Importante

WHvSetVirtualProcessorInterruptControllerState2 está en desuso. Use WHvSetVirtualProcessorState con el tipo de WHvVirtualProcessorStateTypeInterruptControllerState2 estado en su lugar.

Nota:

Esta función solo se aplica a particiones x64.

Syntax

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

Parameters

Partition

Identificador del objeto de partición.

VpIndex

Especifica el índice del procesador virtual cuyo estado del controlador de interrupción está establecido.

State

Especifica el estado del controlador de interrupción que se va a aplicar, en el formato de estado externo estándar.

StateSize

Especifica el tamaño de State, en bytes.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es S_OK.

Si State es , o si StateSize es NULLmenor que el tamaño de estado necesario, el valor devuelto es E_POINTER. Si VpIndex no identifica un procesador virtual existente, el valor devuelto es WHV_E_VP_DOES_NOT_EXIST. Si no se puede tener acceso al procesador virtual en su estado actual, el valor devuelto es WHV_E_INVALID_VP_STATE.

Remarks

La WHvSetVirtualProcessorInterruptControllerState2 función restaura el estado APIC local del procesador virtual especificado a partir de un búfer en el formato de estado externo estándar, normalmente uno generado anteriormente por WHvGetVirtualProcessorInterruptControllerState2. Dado que el registro de prioridad de tarea (TPR) no forma parte del estado del controlador de interrupción del hipervisor, la función también sincroniza el registro del CR8 procesador virtual cuando el TPR proporcionado difiere del valor actual.

La función requiere la emulación del APIC local que se va a configurar para la partición.

Requisitos

Requirement Value
Windows mínima admitidas Windows 10, versión 2004
Header WinHvPlatform.h
Biblioteca WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Consulte también