WHvRequestVpciDeviceInterrupt

向擁有指定虛擬 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

另請參閱