共用方式為


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 值:

傳回碼 描述
STATUS_SUCCESS
作業已順利完成。
STATUS_INVALID_PARAMETER
裝置不會使用 MSI-X,或 TableEntryMessageNumber 參數不會對應至指派給裝置的中斷資源。

言論

根據預設,作系統會將數據表專案的索引指派為中斷的訊息標識碼。 如果數據表專案多於訊息,系統會設定其餘的數據表專案,以對應至訊息零。 驅動程式可以使用 SetTableEntry 例程來指派不同的訊息識別碼。

要求

要求 價值
最低支援的用戶端 適用於 Windows Vista Service Pack 1(SP1)、Windows Server 2008 和更新版本的 Windows作系統。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL <= DIRQL

另請參閱

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE