擷取虛擬處理器的本地 APIC 狀態。
Important
WHvGetVirtualProcessorInterruptControllerState2 已被取代。 建議用 WHvGetVirtualProcessorState 狀態 WHvVirtualProcessorStateTypeInterruptControllerState2 類型。
Note
這個功能只適用於 x64 分割區。
語法
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 轉到 partition 物件。
VpIndex
指定被擷取中斷控制器狀態的虛擬處理器的索引。
State
接收中斷控制器的狀態。
StateSize
指定 的 State大小（以位元組為單位）。
WrittenSize
若非 NULL，則接收寫入 State的位元組數。 當緩衝區太小時，會接收所需的位元組數。
傳回值
如果函式成功，則傳回值為 S_OK。
若 State 太小無法包含中斷控制器狀態，則回傳值為 WHV_E_INSUFFICIENT_BUFFER，並 WrittenSize 接收所需的位元組數。 若 VpIndex 無法識別現有虛擬處理器，則回傳值為 WHV_E_VP_DOES_NOT_EXIST。 若虛擬處理器無法在其當前狀態下存取，則回傳值為 WHV_E_INVALID_VP_STATE。
Remarks
該 WHvGetVirtualProcessorInterruptControllerState2 函式會以標準外部狀態格式取得指定虛擬處理器的本地 APIC 狀態。 它取代了已棄用 WHvGetVirtualProcessorInterruptControllerState的格式，後者回傳一種舊格式，將中斷請求、服務中及觸發模式向量打包方式與標準外部狀態格式不同，且不包含處理器優先暫存器。
此函式需要為分割區設定本地 APIC 的模擬。
Requirements
| 需求 | 價值 |
|---|---|
| 最低支援的 Windows | Windows 10 (版本 2004) |
| Header | WinHvPlatform.h |
| 圖書館 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64 |