HW_INITIALIZE回调函数 （storport.h）
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作系统编写驱动程序的要求。
例如，若要定义 HwStorInitialize 回调例程，该例程名为 myHwInitialize，请使用 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的信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 标头 | storport.h （包括 Storport.h） |
| IRQL | DIRQL （请参阅“备注”部分）。 |