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 |