WHvSetVirtualProcessorInterruptControllerState2

設定虛擬處理器的本地 APIC 狀態。

Important

WHvSetVirtualProcessorInterruptControllerState2 已被取代。 建議用 WHvSetVirtualProcessorState 狀態 WHvVirtualProcessorStateTypeInterruptControllerState2 類型。

Note

這個功能只適用於 x64 分割區。

語法

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

Parameters

Partition

handle 轉到 partition 物件。

VpIndex

指定中斷控制器狀態所設定的虛擬處理器的索引。

State

指定要套用的中斷控制器狀態,採用標準外部狀態格式。

StateSize

指定 的 State大小(以位元組為單位)。

傳回值

如果函式成功,則傳回值為 S_OK

StateNULLStateSize 小於所需狀態大小,則回傳值為 E_POINTER。 若 VpIndex 無法識別現有虛擬處理器,則回傳值為 WHV_E_VP_DOES_NOT_EXIST。 若虛擬處理器無法在其當前狀態下存取,則回傳值為 WHV_E_INVALID_VP_STATE

Remarks

WHvSetVirtualProcessorInterruptControllerState2 函式會從標準外部狀態格式的緩衝區恢復指定虛擬處理器的本地 APIC 狀態,該緩衝區通常是先前由 WHvGetVirtualProcessorInterruptControllerState2產生的。 由於任務優先暫存器(TPR)不屬於虛擬機監控器的中斷控制器狀態,當提供的 TPR 與當前值不同時,該函式也會同步虛擬處理器的 CR8 暫存器。

此函式需要為分割區設定本地 APIC 的模擬。

Requirements

需求 價值
最低支援的 Windows Windows 10 (版本 2004)
Header WinHvPlatform.h
圖書館 WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

另請參閱