共用方式為


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,或 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