通过

StorPortPoFxSetComponentResidency 函数 （storport.h）

  • 项目

StorPortPoFxSetComponentResidency 例程设置在组件进入空闲状态后，存储设备组件可能保持空闲状态的估计时间。

语法

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

参数

[in] HwDeviceExtension

指向主机总线适配器（HBA）的硬件设备扩展的指针。 这是用于在之前调用 StorPortInitializePoFxPower中注册设备的设备扩展。

[in, optional] Address

存储设备单元的地址。 设置存储适配器组件的驻留时，此参数 NULL。

[in] Component

标识组件的索引。 此参数是 组件 数组的索引，该 STOR_POFX_DEVICE 结构中为设备注册的微型端口驱动程序通过调用 StorPortInitializePoFxPower。 如果 组件 数组包含 N 个元素，则组件索引的范围从 0 到 N–1。

[in] Residency

估计的驻留时间，以 100 纳米秒为单位。 此参数是电源管理框架（PoFx）的提示，说明在从活动条件转换为空闲条件后，组件可能保持空闲状态的时间。

返回值

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

返回代码 描述
STOR_STATUS_SUCCESS
 已成功设置组件驻留。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 或 设备 为 NULL。

-或-

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

-或-

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

-或-

组件 中的索引指定大于设备的组件计数的组件。
STOR_STATUS_INVALID_DEVICE_REQUEST
 存储设备未注册到 PoFx。
STOR_STATUS_INVALID_IRQL
 当前的 IRQL > DISPATCH_LEVEL。

要求

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

另请参阅

PoFxSetComponentResidency