PowerSettingRegisterNotification 函数 (powersetting.h)

  • 项目

注册以在电源设置更改时接收通知。

语法

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

参数

[in] SettingGuid

表示电源设置的 GUID。

[in] Flags

有关通知收件人的信息。 此参数可能是以下值之一：

值 含义
DEVICE_NOTIFY_SERVICE_HANDLE
 Recipient 参数是服务的句柄。 使用 CreateService 或 OpenService 函数获取此句柄。
DEVICE_NOTIFY_CALLBACK
 Recipient 参数是指向在电源设置更改时要调用的回调函数的指针。 在这种情况下，收件人应为 PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS 类型。

[in] Recipient

通知收件人的句柄。

[out] RegistrationHandle

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

返回值

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

注解

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

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 powersetting.h
Library Powrprof.lib
DLL Powrprof.dll

另请参阅

电源设置 GUID

PowerSettingUnregisterNotification