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

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

[in] Residency

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

返回值

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

返回代码 说明
STOR_STATUS_SUCCESS
 已成功设置组件驻留。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 或 Device 为 NULL。

-或-

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

-或-

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

-或-

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

要求

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

另请参阅

PoFxSetComponentResidency