WHvGetVirtualProcessorInterruptControllerState2

Recupera el estado APIC local de un procesador virtual.

Importante

WHvGetVirtualProcessorInterruptControllerState2 está en desuso. Use WHvGetVirtualProcessorState con el tipo de WHvVirtualProcessorStateTypeInterruptControllerState2 estado en su lugar.

Nota:

Esta función solo se aplica a particiones x64.

Syntax

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

Identificador del objeto de partición.

VpIndex

Especifica el índice del procesador virtual cuyo estado del controlador de interrupción se recupera.

State

Recibe el estado del controlador de interrupción.

StateSize

Especifica el tamaño de State, en bytes.

WrittenSize

Si no es NULL, recibe el número de bytes escritos en State. Cuando el búfer es demasiado pequeño, recibe el número de bytes necesarios.

Valor devuelto

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

Si State es demasiado pequeño para contener el estado del controlador de interrupción, el valor devuelto es WHV_E_INSUFFICIENT_BUFFERy WrittenSize recibe el número de bytes necesarios. 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 WHvGetVirtualProcessorInterruptControllerState2 función recupera el estado APIC local del procesador virtual especificado en el formato de estado externo estándar. Reemplaza a los vectores en desuso WHvGetVirtualProcessorInterruptControllerState, que devuelve un formato heredado que empaqueta los vectores de solicitud de interrupción, en servicio y modo desencadenador de forma diferente del formato de estado externo estándar y no incluye el registro de prioridad del procesador.

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