共用方式為

PowerRegisterForEffectivePowerModeNotifications 函式 (powersetting.h)

  • 發行項

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

語法

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

參數

Version

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

下列值可以傳入：

  • EFFECTIVE_POWER_MODE_V1從Windows 10 版本 1809開始可供使用，並追蹤效能電源滑杆和省電模式狀態。
  • EFFECTIVE_POWER_MODE_V2從 1903 版Windows 10開始提供，並追蹤效能電源滑杆、省電模式、遊戲模式和視窗混合實境電源狀態。

Callback

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

Context

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

RegistrationHandle

註冊的控制碼。 使用此控制碼取消註冊通知。

傳回值

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

備註

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

需求

   
最低支援的用戶端 Windows 10 版本 1809 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 powersetting.h
程式庫 Powrprof.lib
Dll Powrprof.dll