通过

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 或 设备 为 NULL。

-或-

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

-或-

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

-或-

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

-或-

存储设备已注册到 PoFx。

言论

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

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

要求

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

另请参阅

STOR_POFX_DEVICE