Поделиться через

Функция 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 доступна начиная с Windows 10 версии 1903 и отслеживает ползунок питания производительности, экономию заряда, игровой режим и состояния питания Windows Mixed Reality.

Callback

Указатель на обратный вызов для вызова при изменении действующего режима питания. Это также будет вызываться один раз после регистрации для предоставления текущего режима. Если с помощью этого API зарегистрировано несколько обратных вызовов, эти обратные вызовы можно вызывать параллельно.

Context

Непрозрачный контекст, заданный вызывающим объектом.

RegistrationHandle

Дескриптор регистрации. Используйте этот дескриптор для отмены регистрации уведомлений.

Возвращаемое значение

Возвращает S_OK (ноль), если вызов был выполнен успешно, и ненулевое значение, если вызов завершился неудачно.

Комментарии

Сразу после регистрации будет вызван обратный вызов с текущим значением параметра питания. Если регистрация происходит во время изменения режима питания, вы можете получить несколько обратных вызовов; последний обратный вызов — это последнее обновление.

Требования

   
Минимальная версия клиента Windows 10, версия 1809 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header powersetting.h
Библиотека Powrprof.lib
DLL Powrprof.dll