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 结构的 Context 成员传递。

[in] TableEntry

MSI-X 硬件中断表中表项的索引。

[in] MessageNumber

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

返回值

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

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

注解

默认情况下,操作系统将表项的索引分配为中断的消息 ID。 如果表条目多于消息,系统会将剩余的表条目设置为与消息 0 相对应。 驱动程序可以使用 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