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

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice