PoRegisterForEffectivePowerModeNotifications 函式 (wdm.h)

PoRegisterForEffectivePowerModeNotifications 函式會註冊回呼，以接收有效的電源模式變更通知。

語法

NTSTATUS PoRegisterForEffectivePowerModeNotifications(
  ULONG                             Version,
  PPO_EFFECTIVE_POWER_MODE_CALLBACK Callback,
  PVOID                             Context,
  PO_EPM_HANDLE                     *RegistrationHandle,
  PDEVICE_OBJECT                    DeviceObject
);

參數

Version

提供呼叫端瞭解的最大有效電源模式版本。 如果有效電源模式來自較新的版本，則會對應至接著傳遞至回呼的相容版本。

可以傳入下列值：

• EFFECTIVE_POWER_MODE_V1從 Windows 10 版本 1809 開始可供使用，並追蹤效能電源滑桿和省電模式狀態。

• EFFECTIVE_POWER_MODE_V2從 1903 版 Windows 10 開始提供，並追蹤效能電源滑桿、省電模式、遊戲模式和 Windows 混合實境電源狀態。

Callback

有效電源模式變更時要呼叫之回呼的指標。 註冊時也會呼叫此專案一次，以提供目前的模式。 如果已註冊多個回呼，則可以同時呼叫這些回呼。

Context

呼叫端指定的不透明內容。

RegistrationHandle

這是接收註冊句柄之變數的指標。 此句柄可用來取消註冊回呼函式。

DeviceObject

這是選擇性參數，如果指定的話，會提供已註冊的回呼 (，例如從驅動程式) 指定的裝置內容。

傳回值

如果呼叫成功，則傳回 S_OK (零) ，如果呼叫失敗則傳回非零值。

備註

在註冊之後，將會使用電源設定的目前值叫用回呼。 如果電源模式變更時發生註冊，您可能會收到多個回呼。 最後一個回呼是最新的更新。

規格需求

另請參閱

PO_EFFECTIVE_POWER_MODE

PO_EFFECTIVE_POWER_MODE_CALLBACK

PoUnregisterFromEffectivePowerModeNotifications