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 |