StorPortInitialize 函数 （storport.h）
StorPortInitialize 例程初始化端口驱动程序参数和扩展数据。 StorPortInitialize 还会保存从 微型端口驱动程序DriverEntry 例程提供的适配器信息。
语法
STORPORT_API ULONG StorPortInitialize(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] _HW_INITIALIZATION_DATA *HwInitializationData,
[in, optional] PVOID HwContext
);
参数
[in] Argument1
操作系统调用微型端口 DriverEntry 例程的第一个指针。
[in] Argument2
操作系统调用微型端口 DriverEntry 例程的第二个指针。
[in] HwInitializationData
指向微型端口驱动程序在其 DriverEntry 例程中设置的初始化和配置信息的指针。
[in, optional] HwContext
要传递给微型端口驱动程序的 HwStorFindAdapter 例程的上下文值的地址。 只有扫描总线的 HBA 而不是从端口驱动程序接收配置信息的旧微型端口驱动程序才能使用此参数在调用 HwStorFindAdapter之间存储状态。
返回值
StorPortInitialize执行的初始化操作的结果。 微型端口驱动程序将返回此值作为其 DriverEntry 例程的返回值。
StorPortInitialize 返回以下状态代码之一：
| 返回代码 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | Argument1 为 NULL，或 Argument2 为 NULL，或者 HwInitializationData 为 NULL。 |
| STATUS_SUCCESS | 已成功初始化驱动程序扩展数据和适配器信息。 |
| STATUS_NO_MEMORY | 没有内存可用于存储初始化参数。 |
| STATUS_REVISION_MISMATCH | HwInitializationData 指向的结构版本对于当前操作系统无效。 |
| STATUS_INSUFFICENT_RESOURCES | 驱动程序对象扩展数据的分配失败。 |
言论
必须从微型端口驱动程序的 DriverEntry 例程调用此例程。
由于 Storport 微型端口驱动程序必须支持 PnP，因此 Storport 驱动程序不使用传递给 StorPortInitialize的 HwContext 参数。
每个微型端口驱动程序的 DriverEntry 例程都必须调用 StorPortInitialize 后，微型端口驱动程序首先为零，然后设置 HW_INITIALIZATION_DATA的成员。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 标头 | storport.h （包括 Storport.h） |
| 库 | Storport.lib |