WHvGetVirtualProcessorInterruptControllerState2

Haalt de lokale APIC-status van een virtuele processor op.

Belangrijk

WHvGetVirtualProcessorInterruptControllerState2 is verouderd verklaard. Gebruik WHvGetVirtualProcessorState in plaats daarvan het WHvVirtualProcessorStateTypeInterruptControllerState2 statustype.

Note

Deze functie is alleen van toepassing op x64-partities.

Syntaxis

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

Greep naar het partitieobject.

VpIndex

Hiermee geeft u de index van de virtuele processor waarvan de status van de interruptcontroller wordt opgehaald.

State

Ontvangt de status van de interruptcontroller.

StateSize

Hiermee geeft u de grootte van State, in bytes.

WrittenSize

Als niet-NULL is, ontvangt u het aantal bytes dat naar Stateis geschreven. Wanneer de buffer te klein is, ontvangt deze het aantal vereiste bytes.

Retourwaarde

Als de functie slaagt, is S_OKde retourwaarde .

Als State de status van de interruptcontroller te klein is, is de retourwaarde en WHV_E_INSUFFICIENT_BUFFERWrittenSize ontvangt het aantal vereiste bytes. Als VpIndex een bestaande virtuele processor niet wordt geïdentificeerd, is WHV_E_VP_DOES_NOT_EXISTde retourwaarde . Als de virtuele processor niet kan worden geopend in de huidige status, is WHV_E_INVALID_VP_STATEde retourwaarde .

Remarks

De WHvGetVirtualProcessorInterruptControllerState2 functie haalt de lokale APIC-status van de opgegeven virtuele processor op in de standaardindeling voor externe statussen. Het vervangt de afgeschafte WHvGetVirtualProcessorInterruptControllerStateindeling, die een oudere indeling retourneert die de interrupt-aanvraag, in-service en triggermodus vectoren anders verpakt dan de standaard externe statusindeling en bevat geen register voor processorprioriteit.

De functie vereist emulatie van de lokale APIC om te worden geconfigureerd voor de partitie.

Vereisten

Requirement Value
Minimaal ondersteunde Windows Windows 10, versie 2004
Header WinHvPlatform.h
Bibliotheek WinHvPlatform.lib
DLL WinHvPlatform.dll
Architectuur x64

Zie ook