Share via

StorPortPoFxSetIdleTimeout 函数 (storport.h)

  • 项目

微型端口可以调用 StorPortPoFxSetIdleTimeout 来设置适配器的空闲超时值，即适配器在获取“设备电源不需要”通知之前可以空闲的时间量。

语法

ULONG StorPortPoFxSetIdleTimeout(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         IdleTimeoutInMS
);

参数

HwDeviceExtension

[in]指向微型端口设备扩展的指针。

Address

[in]必须设置为 NULL，因为此函数仅支持适配器。 不要传入单元的地址。

IdleTimeoutInMS

要使用的空闲超时间隔（以毫秒为单位）。

返回值

如果禁用运行时电源或成功设置空闲超时值，StorPortPoFxSetIdleTimeout 将返回STOR_STATUS_SUCCESS。 否则，它将返回如下所示的错误代码之一。

错误代码 含义
STOR_STATUS_INVALID_PARAMETER 已传入单位地址。
STOR_STATUS_UNSUCCESSFUL 以前未成功为适配器调用 StorPortInitializePoFxPower 函数，或者未设置空闲超时值。

注解

如果在为运行时电源管理注册适配器时指定了 STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT 标志并设置了 AdapterIdleTimeoutInMS ，则该值将被传递给此函数的 IdleTimeoutInMS 值重写。 有关如何注册运行时电源管理的信息，请参阅 STOR_POFX_DEVICE_V3 。

如果微型端口以前为适配器调用 StorPortInitializePoFxPower ，则只能调用此函数。

要求

要求 值
最低受支持的客户端 Windows 8
标头 storport.h

另请参阅

STOR_POFX_DEVICE_V3

StorPortInitializePoFxPower