WHvSetVirtualProcessorInterruptControllerState2

Ustawia lokalny stan APIC procesora wirtualnego.

Ważna

WHvSetVirtualProcessorInterruptControllerState2 jest przestarzałe. Zamiast tego należy używać WHvSetVirtualProcessorState z typem WHvVirtualProcessorStateTypeInterruptControllerState2 stanu.

Note

Ta funkcja dotyczy tylko partycji x64.

Składnia

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

Parameters

Partition

Dojście do obiektu partycji.

VpIndex

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

State

Określa stan kontrolera przerwań do zastosowania w standardowym formacie stanu zewnętrznego.

StateSize

Określa rozmiar State, w bajtach.

Wartość zwracana

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

Jeśli State wartość to NULL, lub jest StateSize mniejsza niż wymagany rozmiar stanu, zwracana wartość to E_POINTER. 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 WHvSetVirtualProcessorInterruptControllerState2 przywraca lokalny stan APIC określonego procesora wirtualnego z buforu w standardowym formacie stanu zewnętrznego, zazwyczaj jeden wcześniej utworzony przez WHvGetVirtualProcessorInterruptControllerState2program . Ponieważ rejestr priorytetów zadań (TPR) nie jest częścią stanu kontrolera przerwań funkcji hypervisor, funkcja synchronizuje również rejestr procesora CR8 wirtualnego, gdy podany TPR różni się od bieżącej wartości.

Funkcja wymaga emulacji lokalnej APIC do skonfigurowania dla partycji.

Requirements

Requirement Value
Minimalna obsługiwana Windows Windows 10, wersja 2004
Header WinHvPlatform.h
Biblioteka WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Zobacz także