PCI_MSIX_SET_ENTRY回呼函式 (wdm.h)
SetTableEntry 例程會設定 MSI-X 硬體中斷數據表中數據表專案的訊息識別碼。
語法
PCI_MSIX_SET_ENTRY PciMsixSetEntry;
NTSTATUS PciMsixSetEntry(
[in] PVOID Context,
[in] ULONG TableEntry,
[in] ULONG MessageNumber
)
{...}
參數
[in] Context
介面特定內容資訊的指標。 呼叫端會傳遞作為介面 PCI_MSIX_TABLE_CONFIG_INTERFACE 結構之 內容成員傳遞的值。
[in] TableEntry
MSI-X 硬體中斷數據表中數據表專案的索引。
[in] MessageNumber
中斷的訊息標識碼。 這個值也是 MessageInfo 中中斷專案的索引, 結構 IO_INTERRUPT_MESSAGE_INFO 的成員,描述驅動程式訊息訊號中斷。 IoConnectInterruptEx 函式會提供此結構的指標。
傳回值
SetTableEntry 例程可能會傳回下列其中一個 NTSTATUS 值:
傳回碼 | 描述 |
---|---|
|
作業已順利完成。 |
|
裝置不會使用 MSI-X,或 TableEntry 或 MessageNumber 參數不會對應至指派給裝置的中斷資源。 |
言論
根據預設,作系統會將數據表專案的索引指派為中斷的訊息標識碼。 如果數據表專案多於訊息,系統會設定其餘的數據表專案,以對應至訊息零。 驅動程式可以使用 SetTableEntry 例程來指派不同的訊息識別碼。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista Service Pack 1(SP1)、Windows Server 2008 和更新版本的 Windows作系統。 |
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | <= DIRQL |