PoFxStartDevicePowerManagement 函式 (wdm.h)
PoFxStartDevicePowerManagement 例程會完成使用電源管理架構註冊裝置, (PoFx) 並啟動裝置電源管理。
語法
void PoFxStartDevicePowerManagement(
[in] POHANDLE Handle
);
參數
[in] Handle
句柄,表示使用電源管理架構註冊裝置, (PoFx) 。 設備驅動器先前已從 PoFxRegisterDevice 例程收到此句柄。
傳回值
無
備註
在驅動程式呼叫 PoFxRegisterDevice 例程向 PoFx 註冊裝置之後,裝置中的所有元件都會完全開啟且處於作用中狀態,讓驅動程式可以完成硬體初始化。 若要開始主動式電源管理,驅動程式必須呼叫 PoFxStartDevicePowerManagement。 根據預設,此呼叫會將所有元件切換至閑置狀況。
在 PoFxStartDevicePowerManagement 將元件切換至閑置條件之後,PoFx 可能會立即開始呼叫驅動程式的回呼例程,即使在 PoFxStartDevicePowerManagement 傳回之前也一樣。 PoFx 會呼叫驅動程式的 ComponentIdleConditionCallback 回 呼例程,以指出元件已切換至閑置狀況。 驅動程式不得存取處於閑置條件的元件。 在驅動程式可以存取元件之前,驅動程式必須呼叫 PoFxActivateComponent ,並等候 PoFx 呼叫驅動程式的 ComponentActiveConditionCallback 回 呼例程。 此回呼會通知驅動程式元件處於使用中狀況,並可安全地存取。
如果驅動程式要求元件在電源管理啟動后立即處於作用中條件,驅動程式必須藉由呼叫 PoFxActivateComponent 例程明確地啟動元件,而且此呼叫必須在 PoFxRegisterDevice 呼叫之後,但在 PoFxStartDevicePowerManagement 呼叫之前發生。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h |
程式庫 | Ntoskrnl.lib |
Dll | Ntoskrnl.exe |
IRQL | PASSIVE_LEVEL |
另請參閱
ComponentActiveConditionCallback