WHvGetVirtualProcessorInterruptControllerState2

Récupère l’état APIC local d’un processeur virtuel.

Important

WHvGetVirtualProcessorInterruptControllerState2 est déconseillé. Utilisez WHvGetVirtualProcessorState plutôt le type d’état WHvVirtualProcessorStateTypeInterruptControllerState2 .

Note

Cette fonction s’applique uniquement aux partitions x64.

Syntaxe

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
    );

Paramètres

Partition

Gérer l’objet de partition.

VpIndex

Spécifie l’index du processeur virtuel dont l’état du contrôleur d’interruption est récupéré.

State

Reçoit l’état du contrôleur d’interruption.

StateSize

Spécifie la taille de State, en octets.

WrittenSize

Si la valeur n’est pas NULL, reçoit le nombre d’octets écrits dans State. Lorsque la mémoire tampon est trop petite, elle reçoit le nombre d’octets requis.

Valeur de retour

Si la fonction réussit, la valeur de retour est S_OK.

Si State elle est trop petite pour contenir l’état du contrôleur d’interruption, la valeur de retour est WHV_E_INSUFFICIENT_BUFFERet WrittenSize reçoit le nombre d’octets requis. Si VpIndex elle n’identifie pas un processeur virtuel existant, la valeur de retour est WHV_E_VP_DOES_NOT_EXIST. Si le processeur virtuel n’est pas accessible dans son état actuel, la valeur de retour est WHV_E_INVALID_VP_STATE.

Remarks

La WHvGetVirtualProcessorInterruptControllerState2 fonction récupère l’état APIC local du processeur virtuel spécifié au format d’état externe standard. Il remplace le format déconseillé WHvGetVirtualProcessorInterruptControllerState, qui retourne un format hérité qui packse la demande d’interruption, le mode in-service et les vecteurs en mode déclencheur différemment du format d’état externe standard et n’inclut pas le registre de priorité du processeur.

La fonction nécessite l’émulation de l’APIC local à configurer pour la partition.

Exigences

Requirement Valeur
Windows minimum pris en charge Windows 10, version 2004
Header WinHvPlatform.h
Bibliothèque WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Voir aussi