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結構之Context成員傳遞的值。

[in] TableEntry

MSI-X 硬體中斷數據表中數據表專案的索引。

[in] MessageNumber

中斷的訊息標識碼。這個值也是描述驅動程式訊息訊號中斷中斷之IO_INTERRUPT_MESSAGE_INFO結構之 MessageInfo 成員中中斷專案的索引。 IoConnectInterruptEx 函式會提供這個結構的指標。

SetTableEntry 例程可能會傳回下列其中一個 NTSTATUS 值：

傳回碼	Description
STATUS_SUCCESS	作業已成功完成。
STATUS_INVALID_PARAMETER	裝置不會使用 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