設定虛擬處理器的本地 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。
若 State , NULL或 StateSize 小於所需狀態大小,則回傳值為 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 |