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 值之一:
返回代码 | 描述 |
---|---|
|
作已成功完成。 |
|
设备不使用 MSI-X,或者 TableEntry 或 MessageNumber 参数与分配给设备的中断资源不对应。 |
言论
默认情况下,作系统将表项的索引指定为中断的消息 ID。 如果表项多于消息,系统将剩余的表项设置为对应于消息零。 驱动程序可以使用 SetTableEntry 例程来分配不同的消息 ID。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 中提供 Service Pack 1(SP1)、Windows Server 2008 和更高版本的 Windows作系统。 |
目标平台 | 桌面 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | <= DIRQL |