WHvSetVirtualProcessorInterruptControllerState2

Définit l’état APIC local d’un processeur virtuel.

Important

WHvSetVirtualProcessorInterruptControllerState2 est déconseillé. Utilisez WHvSetVirtualProcessorState plutôt le type d’état WHvVirtualProcessorStateTypeInterruptControllerState2 .

Note

Cette fonction s’applique uniquement aux partitions x64.

Syntaxe

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

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 défini.

State

Spécifie l’état du contrôleur d’interruption à appliquer, au format d’état externe standard.

StateSize

Spécifie la taille de State, en octets.

Valeur de retour

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

Si State c’est le cas ou s’il StateSize est NULLinférieur à la taille d’état requise, la valeur de retour est E_POINTER. 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 WHvSetVirtualProcessorInterruptControllerState2 fonction restaure l’état APIC local du processeur virtuel spécifié à partir d’une mémoire tampon au format d’état externe standard, généralement un précédemment produit par WHvGetVirtualProcessorInterruptControllerState2. Étant donné que le registre de priorité des tâches (TPR) ne fait pas partie de l’état du contrôleur d’interruption de l’hyperviseur, la fonction synchronise également le registre du CR8 processeur virtuel lorsque le TPR fourni diffère de la valeur actuelle.

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