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 |