WHvGetVirtualProcessorInterruptControllerState2

Pobiera lokalny stan APIC procesora wirtualnego.

Składnia

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

Dojście do obiektu partycji.

VpIndex

Określa indeks procesora wirtualnego, którego stan kontrolera przerwań jest pobierany.

State

Odbiera stan kontrolera przerwań.

StateSize

Określa rozmiar State, w bajtach.

WrittenSize

Jeśli wartość nie ma wartości NULL, otrzymuje liczbę bajtów zapisanych w pliku State. Gdy bufor jest za mały, otrzymuje wymaganą liczbę bajtów.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość to S_OK.

Jeśli State jest za mały, aby zawierać stan kontrolera przerwań, zwracana wartość to WHV_E_INSUFFICIENT_BUFFER, i WrittenSize otrzymuje wymaganą liczbę bajtów. Jeśli VpIndex nie zidentyfikuje istniejącego procesora wirtualnego, zwracana wartość to WHV_E_VP_DOES_NOT_EXIST. Jeśli nie można uzyskać dostępu do procesora wirtualnego w bieżącym stanie, zwracana wartość to WHV_E_INVALID_VP_STATE.

Remarks

Funkcja WHvGetVirtualProcessorInterruptControllerState2 pobiera lokalny stan APIC określonego procesora wirtualnego w standardowym formacie stanu zewnętrznego. Zastępuje przestarzały WHvGetVirtualProcessorInterruptControllerStateformat , który zwraca starszy format, który pakuje wektory żądania przerwania, w usłudze i tryb wyzwalacza inaczej niż standardowy format stanu zewnętrznego i nie zawiera rejestru priorytetu procesora.

Funkcja wymaga emulacji lokalnej APIC do skonfigurowania dla partycji.

Requirements

Zobacz także

• WHvSetVirtualProcessorInterruptControllerState2
• WHvGetVirtualProcessorInterruptControllerState
• WHvGetVirtualProcessorState
• Windows Definicje interfejsu API platformy funkcji Hypervisor