通过

PowerRegisterForEffectivePowerModeNotifications 函数 (powersetting.h)

  • 项目

注册回调以接收有效的电源模式更改通知。

语法

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

parameters

Version

提供调用方理解的最大有效电源模式版本。 如果有效电源模式来自更高版本，则会将其缩减为兼容版本，然后传递给回调。

可以传入以下值：

  • EFFECTIVE_POWER_MODE_V1从Windows 10 版本 1809开始提供，可跟踪性能电源滑块和节电模式状态。
  • EFFECTIVE_POWER_MODE_V2从 Windows 10 版本 1903 开始提供，可跟踪性能电源滑块、节电模式、游戏模式和 Windows 混合现实电源状态。

Callback

指向在有效电源模式更改时要调用的回调的指针。 注册时还会调用一次，以提供当前模式。 如果使用此 API 注册了多个回调，则可以同时调用这些回调。

Context

调用方指定的不透明上下文。

RegistrationHandle

注册的句柄。 使用此句柄取消注册通知。

返回值

如果调用成功，则返回S_OK (零) ;如果调用失败，则返回非零值。

注解

注册后，将立即使用电源设置的当前值调用回调。 如果在电源模式更改时发生注册，可能会收到多个回调：最后一个回调是最新的更新。

要求

   
最低受支持的客户端 Windows 10 版本 1809 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 powersetting.h
Library Powrprof.lib
DLL Powrprof.dll