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