Функция 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
Header powersetting.h
Библиотека Powrprof.lib
DLL Powrprof.dll

См. также раздел

Идентификаторы GUID параметров питания

PowerSettingUnregisterNotification