WHvSetVirtualProcessorInterruptControllerState2

Legt den lokalen APIC-Status eines virtuellen Prozessors fest.

Important

WHvSetVirtualProcessorInterruptControllerState2 ist veraltet. Verwenden Sie WHvSetVirtualProcessorState stattdessen den Zustandstyp WHvVirtualProcessorStateTypeInterruptControllerState2 .

Note

Diese Funktion gilt nur für x64-Partitionen.

Syntax

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

Parameter

Partition

Behandeln sie das Partitionsobjekt.

VpIndex

Gibt den Index des virtuellen Prozessors an, dessen Interruptcontrollerzustand festgelegt ist.

State

Gibt den anzuwendenden Interruptcontrollerstatus im standardmäßigen externen Zustandsformat an.

StateSize

Gibt die Größe von State, in Byte an.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet S_OKder Rückgabewert .

Wenn State dies der Wert ist NULLoder StateSize kleiner als die erforderliche Zustandsgröße ist, lautet E_POINTERder Rückgabewert . Wenn VpIndex kein vorhandener virtueller Prozessor identifiziert wird, lautet WHV_E_VP_DOES_NOT_EXISTder Rückgabewert . Wenn auf den virtuellen Prozessor im aktuellen Zustand nicht zugegriffen werden kann, lautet WHV_E_INVALID_VP_STATEder Rückgabewert .

Remarks

Die WHvSetVirtualProcessorInterruptControllerState2 Funktion stellt den lokalen APIC-Zustand des angegebenen virtuellen Prozessors aus einem Puffer im Standardmäßigen externen Zustandsformat wieder her, in der Regel eines zuvor von WHvGetVirtualProcessorInterruptControllerState2. Da das Aufgabenprioritätsregister (Task Priority Register, TPR) nicht Teil des Interruptcontrollerzustands des Hypervisors ist, synchronisiert die Funktion auch das Register des virtuellen Prozessors CR8 , wenn sich die bereitgestellte TPR vom aktuellen Wert unterscheidet.

Für die Funktion muss die lokale APIC-Emulation für die Partition konfiguriert werden.

Anforderungen

Anforderung Wert
Mindestens unterstützte Windows Windows 10, Version 2004
Header WinHvPlatform.h
Bibliothek WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Siehe auch