向擁有指定虛擬 PCI 裝置的分割區發送邏輯中斷。
語法
HRESULT
WINAPI
WHvRequestVpciDeviceInterrupt(
_In_ WHV_PARTITION_HANDLE Partition,
_In_ UINT64 LogicalDeviceId,
_In_ UINT64 MsiAddress,
_In_ UINT32 MsiData
);
Parameters
Partition
處理到擁有虛擬 PCI 裝置的分割區。
LogicalDeviceId
指定虛擬 PCI 裝置的邏輯裝置 ID,該裝置在建立時所指派。
MsiAddress
指定要傳送的中斷 MSI 位址,並由 WHvMapVpciDeviceInterrupt。
MsiData
指定中斷要傳遞的 MSI 資料有效載荷,依 。WHvMapVpciDeviceInterrupt
傳回值
如果函式成功,則傳回值為 S_OK。
在 x64 上,若 MsiAddress 大於 0xFFFFFFFF,則該函數返回 HRESULT_FROM_WIN32(ERROR_HV_INVALID_PARAMETER)。 虛擬機監控程式會執行裝置的剩餘驗證與中斷。
Remarks
該 WHvRequestVpciDeviceInterrupt 函式會為啟用邏輯中斷的裝置斷言中斷。 中斷由 MsiAddressMsiData 和 回傳 WHvMapVpciDeviceInterrupt的值識別,並傳送給目前映射所針對的虛擬處理器。
此呼叫讓虛擬化堆疊能代表裝置注入中斷,而非依賴實體資源來發出訊號。 在請求外送前,先將中斷 WHvMapVpciDeviceInterrupt 映射為 。
Requirements
| 需求 | 價值 |
|---|---|
| 最低支援的 Windows | Windows 10,版本 20H2(x64);Windows 11,版本 24H2,建置版 26100.3915(Arm64) |
| Header | WinHvPlatform.h |
| 圖書館 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64、Arm64 |