PCI_MSIX_SET_ENTRY回调函数 (wdm.h)

SetTableEntry 例程为 MSI-X 硬件中断表中的表项设置消息 ID。

语法

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

中断的消息 ID。 此值也是描述驱动程序消息信号中断的 IO_INTERRUPT_MESSAGE_INFO 结构的 MessageInfo 成员中中断项的索引。 IoConnectInterruptEx 函数提供指向此结构的指针。

返回值

SetTableEntry 例程可能返回以下 NTSTATUS 值之一:

返回代码 描述
STATUS_SUCCESS
作已成功完成。
STATUS_INVALID_PARAMETER
设备不使用 MSI-X,或者 TableEntryMessageNumber 参数与分配给设备的中断资源不对应。

言论

默认情况下,作系统将表项的索引指定为中断的消息 ID。 如果表项多于消息,系统将剩余的表项设置为对应于消息零。 驱动程序可以使用 SetTableEntry 例程来分配不同的消息 ID。

要求

要求 价值
最低支持的客户端 在 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