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