HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE回调函数 (storport.h)

项目
02/26/2024

HwMSInterruptRoutine 例程 (MSI) 处理消息信号中断。

语法

HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE HwMessageSignaledInterruptRoutine;

BOOLEAN HwMessageSignaledInterruptRoutine(
  IN PVOID HwDeviceExtension,
  IN ULONG MessageId
)
{...}

参数

HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

MessageId

消息的标识符。

返回值

如果 HwMSInterruptRoutine 确定 HBA 生成了 MSI，则返回 TRUE。如果 HBA 未生成 MSI， 则 HwMSInterruptRoutine 返回 FALSE。

注解

微型端口驱动程序的 HwMSInterruptRoutine 例程处理由 HBA 生成的 (MSI) 的消息信号中断。微型端口驱动程序指示其 HBA 通过将 PORT_CONFIGURATION_INFORMATION 结构的 HwMSInterruptRoutine 成员设置为指向 HwMSInterruptRoutine 例程来生成 MSI。如果 HBA 未生成 MSI，微型端口驱动程序应将 HwMSInterruptRoutine 设置为 NULL。

如果 PORT_CONFIGURATION_INFORMATION 结构的 InterruptSynchronizationMode 成员设置为 InterruptSynchronizeAll，则 Storport 驱动程序将同步源自其管理的适配器或连接到适配器的设备的所有 MSI。发生中断时，Storport 驱动程序在获取中断旋转锁后，在 DIRQL 调用微型端口驱动程序的 HwMSInterruptRoutine 例程。

如果 PORT_CONFIGURATION_INFORMATION 结构的 InterruptSynchronizationMode 成员设置为 InterruptSynchronizePerMessage，则 Storport 驱动程序在 IRQL = DIRQL 处调用微型端口驱动程序的 HwMSInterruptRoutine 例程，并持有与 MessageID 参数中指示的消息标识符 (ID) 对应的中断旋转锁。 HBA 可以中断 HwMSInterruptRoutine 例程以中断其他消息 ID，因此 Storport 驱动程序可能会对 HwMSInterruptRoutine 进行嵌套调用，或者在不同的处理器上同时运行 HwMSInterruptRoutine 的不同实例。若要同步 HwMSInterruptRoutine 的不同实例对敏感数据的访问，微型端口必须调用 StorPortAcquireMSISpinLock 和 StorPortReleaseMSISpinLock 例程来获取和释放 MessageID 中 ID 以外的消息 ID 的旋转锁。

微型端口驱动程序可以通过调用 StorPortGetMSIInfo 例程来检索有关消息的其他信息。

它不应从 HwMSInterruptRoutine 例程内部调用 StorPortGetMSIInfo 例程。

名称 HwMSInterruptRoutine 只是占位符。此例程的实际原型在 Storport.h 中定义，如下所示：

typedef
BOOLEAN
  HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE (
    _In_ PVOID  HwDeviceExtension,
    _In_ ULONG  MessageId
    );

示例

若要定义 HwMSInterruptRoutine 回调函数，必须首先提供一个函数声明，用于标识要定义的回调函数的类型。 Windows 为驱动程序提供一组回调函数类型。使用回调函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序 (SDV) 和其他验证工具查找错误，并且这是编写适用于 Windows 操作系统的驱动程序的要求。

例如，若要定义名为 MyHwMSIRoutine 的 HwMSInterruptRoutine 回调例程，请使用 HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE 类型，如以下代码示例所示：

HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE MyHwMSIRoutine;

然后，按如下所示实现回调例程：

_Use_decl_annotations_
BOOLEAN
MyHwMSIRoutine (
  _In_ PVOID  DeviceExtension,
  _In_ ULONG  MessageId
  );
  {
      ...
  }

HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE函数类型在 Storport.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations注释可确保使用应用于头文件中HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE函数类型的注释。有关函数声明要求的详细信息，请参阅使用 Storport 驱动程序的函数角色类型声明函数。有关 Use_decl_annotations的信息，请参阅批注函数行为。