HW_INITIALIZE回调函数 (storport.h)

项目
02/29/2024

HwStorInitialize 例程在系统重新启动或电源故障后初始化微型端口驱动程序。它在 HwStorFindAdapter 成功返回后由 StorPort 调用。 HwStorInitialize 初始化 HBA 并查找微型端口驱动程序感兴趣的所有设备。

语法

HW_INITIALIZE HwInitialize;

BOOLEAN HwInitialize(
  PVOID DeviceExtension
)
{...}

参数

DeviceExtension

指向微型端口驱动程序的每个 HBA 存储区域的指针。

返回值

如果初始化成功， 则 HwStorInitialize 返回 TRUE。

注解

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

typedef
BOOLEAN
HW_INITIALIZE (
  _In_ PVOID  DeviceExtension
  );

由于在 DIRQL 中调用 HwStorInitialize ，因此应尽可能多地由 HwStorPassiveInitializeRoutine 执行初始化过程。如果是这样，则必须通过 StorPortEnablePassiveInitialization 启用被动初始化例程。

如果硬件初始化生成中断，则将调用 HwStorInterrupt 例程。在这种情况下， HwStorInitialize 例程应设置 HwStorInterrupt 期望的任何数据 (包括 HwStorDpcRoutine（如果在开始初始化硬件之前) 使用）。

HwStorInitialize 和 HwStorPassiveInitializeRoutine 之间分担以下责任：

初始化 HBA 寄存器和缓冲区的硬件。
初始化和分配所有 DeviceExtension 字段。
设置和初始化微型端口驱动程序使用的所有事件和 DPC。

示例

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

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

HW_INITIALIZE MyHwInitialize;

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

_Use_decl_annotations_
BOOLEAN 
  MyHwInitialize( _In_ PVOID DeviceExtension )
  {
      ...
  }

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