WHvGetVirtualProcessorInterruptControllerState2

Recupera lo stato APIC locale di un processore virtuale.

Importante

WHvGetVirtualProcessorInterruptControllerState2 è obsoleto. Usare WHvGetVirtualProcessorState invece con il WHvVirtualProcessorStateTypeInterruptControllerState2 tipo di stato.

Note

Questa funzione si applica solo alle partizioni x64.

Sintassi

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

Handle per l'oggetto partizione.

VpIndex

Specifica l'indice del processore virtuale il cui stato del controller di interrupt viene recuperato.

State

Riceve lo stato del controller di interrupt.

StateSize

Specifica le dimensioni di State, in byte.

WrittenSize

Se non NULL, riceve il numero di byte scritti in State. Quando il buffer è troppo piccolo, riceve il numero di byte necessari.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è S_OK.

Se State è troppo piccolo per contenere lo stato del controller di interrupt, il valore restituito è WHV_E_INSUFFICIENT_BUFFERe WrittenSize riceve il numero di byte necessari. Se VpIndex non identifica un processore virtuale esistente, il valore restituito è WHV_E_VP_DOES_NOT_EXIST. Se non è possibile accedere al processore virtuale nello stato corrente, il valore restituito è WHV_E_INVALID_VP_STATE.

Remarks

La WHvGetVirtualProcessorInterruptControllerState2 funzione recupera lo stato APIC locale del processore virtuale specificato nel formato di stato esterno standard. Sostituisce il deprecato WHvGetVirtualProcessorInterruptControllerState, che restituisce un formato legacy che include i vettori interrupt-request, in-service e in modalità trigger in modo diverso dal formato di stato esterno standard e non include il registro di priorità del processore.

La funzione richiede l'emulazione dell'APIC locale per la partizione.

Requisiti

Requisito Valore
Minimo Windows supportato Windows 10, versione 2004
Header WinHvPlatform.h
Libreria WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Vedere anche