PoFxReportDevicePoweredOn 函式 (wdm.h)

PoFxReportDevicePoweredOn 例程會通知 Power Management Framework (PoFx) 裝置已完成要求轉換至 D0 (完全在) 電源狀態。

語法

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

參數

[in] Handle

句柄，表示使用電源管理架構註冊裝置， (PoFx) 。 設備驅動器先前已從 PoFxRegisterDevice 例程收到此句柄。

傳回值

無

備註

已註冊裝置的驅動程序必須在發生下列任何情況之後呼叫 PoFxReportDevicePoweredOn ：

• PoFx 會呼叫驅動程式的 DevicePowerRequiredCallback 回 呼例程，以通知驅動程式裝置必須進入 D0 電源狀態。
• PoFx 會呼叫驅動程式的 DirectedPowerUpCallback 回 呼例程，以通知驅動程式裝置必須進入 D0 電源狀態。
• PoFx 會將 S0 IRP 傳送給驅動程式， (IRP_MN_SET_POWER 要求) ，以通知驅動程式暫止的系統轉換至 S0 電源狀態。

無論是否需要 D0 IRP、D0 IRP 要求失敗、分派的 D0 IRP 成功或失敗，或 S0 IRP 成功或失敗，驅動程式都必須呼叫 PoFxReportDevicePoweredOn 。

針對所需的電源/導向電源回呼， PoFxReportDevicePoweredOn 呼叫可以在回呼呼叫期間或之後發生。

針對 S0 IRP 要求，驅動程式必須儘快完成此要求、將裝置切換至 D0 電源狀態，然後呼叫 PoFxReportDevicePoweredOn。 如需詳細資訊，請參閱 在裝置電源原則擁有者中處理系統 Set-Power IRP。

進入 PoFxReportDevicePoweredOn 時，裝置可能處於未初始化的 D0 電源狀態，裝置中的所有元件都會開啟。 為了回應 PoFxReportDevicePoweredOn呼叫，PoFx 會以初始化的 D0 狀態設定裝置。 在此設定期間，PoFx 會切換為低電量 Fx 電源狀態的元件數目。

規格需求

另請參閱

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice