Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft den lokalen APIC-Status eines virtuellen Prozessors ab.
Important
WHvGetVirtualProcessorInterruptControllerState2 ist veraltet. Verwenden Sie WHvGetVirtualProcessorState stattdessen den Zustandstyp WHvVirtualProcessorStateTypeInterruptControllerState2 .
Note
Diese Funktion gilt nur für x64-Partitionen.
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
);
Parameter
Partition
Behandeln sie das Partitionsobjekt.
VpIndex
Gibt den Index des virtuellen Prozessors an, dessen Interruptcontrollerzustand abgerufen wird.
State
Empfängt den Zustand des Interruptcontrollers.
StateSize
Gibt die Größe von State, in Byte an.
WrittenSize
Wenn kein NULL-Wert vorhanden ist, wird die Anzahl der Bytes empfangen, die in State. Wenn der Puffer zu klein ist, erhält er die erforderliche Anzahl von Bytes.
Rückgabewert
Wenn die Funktion erfolgreich ist, lautet S_OKder Rückgabewert .
Wenn State zu klein ist, um den Interruptcontrollerzustand zu enthalten, lautet WHV_E_INSUFFICIENT_BUFFERder Rückgabewert und WrittenSize empfängt die Anzahl der erforderlichen Bytes. 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 WHvGetVirtualProcessorInterruptControllerState2 Funktion ruft den lokalen APIC-Zustand des angegebenen virtuellen Prozessors im standardmäßigen externen Zustandsformat ab. Es ersetzt das veraltete WHvGetVirtualProcessorInterruptControllerStateFormat, das ein älteres Format zurückgibt, das die Interrupt-Anforderung, die In-Service- und Triggermodusvektoren anders als das standardmäßige externe Zustandsformat enthält und nicht das Prozessorprioritätsregister enthält.
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 |