PoFxSetDeviceIdleTimeout 函式 (wdm.h)

PoFxSetDeviceIdleTimeout 例程會指定當電源管理架構 (PoFx) 呼叫驅動程式的 DevicePowerNotRequiredCallback 例程時，裝置最後一個元件進入閑置條件的最短時間間隔。

語法

void PoFxSetDeviceIdleTimeout(
  [in] POHANDLE  Handle,
  [in] ULONGLONG IdleTimeout
);

參數

[in] Handle

句柄，表示向PoFx註冊裝置。 設備驅動器先前已從 PoFxRegisterDevice 例程收到此句柄。

[in] IdleTimeout

100 奈秒單位的閑置超時時間間隔。 如需詳細資訊，請參閱＜備註＞。

傳回值

無

備註

此例程會指定將PoFx套用至驅動程式 DevicePowerNotRequiredCallback回 呼例程的未來呼叫的超時時間間隔。 根據預設，此逾時間隔為零，在此情況下，PoFx 可能會呼叫 DevicePowerNotRequiredCallback 例程，只要裝置準備好切換到低電量 Dx 狀態即可。 不過，驅動程式可能會偏好延遲此轉換，並將裝置保持在 D0 電源狀態，以取得一些額外的超時時間間隔。 在此情況下，如果裝置在逾時間隔結束時變成作用中，因此需要保持 D0 狀態，則不再需要擱置的 DevicePowerNotRequiredCallback 呼叫，而且 PoFx 會取消。

例如，為了改善效能並減少耗用，儲存設備驅動器可能會想要防止旋轉的磁碟驅動器進入 D3 並變慢，直到磁碟驅動器閑置的時間夠長。 為了簡化此驅動程式的 DevicePowerNotRequiredCallback 回 呼例程實作， PoFxSetDeviceIdleTimeout 例程可讓驅動程式自動延遲 D3 轉換，而不需要驅動程式設定定時器。

當裝置的所有元件完成其轉換至閑置狀況時，就會開始逾時間隔。 一般而言，PoFx 會等到超時時間間隔結束，以呼叫 DevicePowerNotRequiredCallback 例程。 不過，如果 PoFx 正在準備進入低電源系統狀態，PoFx 可能會提早結束超時時間間隔。 在任何情況下，當 PoFx 呼叫驅動程式的 DevicePowerNotRequiredCallback 例程時，驅動程式應該切換至低電量 Dx 狀態，而不會進一步延遲。

設備驅動器可以在每次條件變更時呼叫 PoFxSetDeviceIdleTimeout ，而需要閑置超時時間間隔的變更。 每次呼叫之後，新的閑置逾時間隔會維持有效狀態，直到驅動程式再次呼叫 PoFxSetDeviceIdleTimeout 以更新它為止。

規格需求

另請參閱

DevicePowerNotRequiredCallback

PoFxRegisterDevice