StorPortInitializePoFxPower 函数 (storport.h)

  • 项目

微型端口驱动程序调用 StorPortInitializePoFxPower ，以将存储设备注册到电源管理框架 (PoFx) 。

语法

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

参数

[in] HwDeviceExtension

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

[in, optional] Address

存储设备单元的地址。 注册存储适配器时，此参数为 NULL 。

[in] Device

指向 STOR_POFX_DEVICE_V2 结构的指针转换为 指向STOR_POFX_DEVICE的指针。 此结构包含存储设备具有 F 状态的组件列表。

[in, out] D3ColdEnabled

指向 BOOLEAN 值的指针，Storport 驱动程序会将该值设置为指示是否为存储设备启用了 D3 冷状态。

返回值

StorPortInitializePoFxPower 例程返回以下状态代码之一：

返回代码 说明
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 或 Device 为 NULL。

-或-

地址 指向无效的单位地址结构。

-或-

找不到 地址 指定的存储设备。

-或-

设备指向STOR_POFX_DEVICE结构的格式不正确或包含无效数据。
STOR_STATUS_SUCCESS
 存储设备已成功注册到 PoFx。
STOR_STATUS_INSUFFICIENT_RESOURCES
 没有足够的资源可用于向 PoFx 注册存储设备。
STOR_STATUS_UNSUCCESSFUL
 存储设备未成功注册到 PoFx。

-或-

存储设备已注册到 PoFx。

注解

适配器设备始终使用地址的 NULL 值进行注册。 通过为 地址指定有效的单位地址来注册单元设备。

如果在 Device 的 Flags 成员中设置了 STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD 标志，Storport 将尝试为设备组件启用 D3 冷支持。 D3ColdEnabled 指向的 BOOLEAN 值中返回 D3 冷启用状态。

要求

要求 值
最低受支持的客户端 从 Windows 8 开始可用。
目标平台 通用
标头 storport.h

另请参阅

STOR_POFX_DEVICE