WM_POWER сообщение

Уведомляет приложения о том, что система, обычно персональный компьютер с питанием от батареи, вот-вот перейдет в приостановленный режим.

Примечание

Сообщение WM_POWER устарело. Он предоставляется только для совместимости с 16-разрядными приложениями Windows. Приложения должны использовать сообщение WM_POWERBROADCAST .

Окно получает это сообщение через функцию WindowProc .

LRESULT CALLBACK WindowProc
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWER
  WPARAM wParam,  // power-event notification
  LPARAM lParam   // not used
); 

Параметры

hwnd

Дескриптор окна.

uMsg

Идентификатор сообщения WM_POWER .

wParam

Уведомление о событиях power. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
PWR_CRITICALRESUME
Указывает, что система возобновляет работу после выхода в приостановленный режим без предварительной передачи PWR_SUSPENDREQUEST уведомления в приложение. Приложение должно выполнять все необходимые действия по восстановлению.
PWR_SUSPENDREQUEST
Указывает, что система переходит в приостановленный режим.
PWR_SUSPENDRESUME
Указывает, что система возобновляет работу после того, как она вошла в режим приостановки в обычном режиме, то есть система передает приложению PWR_SUSPENDREQUEST уведомление перед приостановкой системы. Приложение должно выполнять все необходимые действия по восстановлению.

lParam

Этот параметр не используется.

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

Значение, возвращаемое приложением, зависит от значения параметра wParam . Если wParamPWR_SUSPENDREQUEST, возвращаемое значение PWR_FAIL , чтобы предотвратить переход системы в приостановленное состояние; в противном случае это PWR_OK. Если wParam имеет значение PWR_SUSPENDRESUME или PWR_CRITICALRESUME, возвращаемое значение равно нулю.

Комментарии

Это сообщение передается только приложению, работающему в системе, которая соответствует спецификации базовой системы ввода и вывода расширенного управления питанием (APM). Сообщение передается драйвером управления питанием в каждое окно, возвращаемое функцией EnumWindows .

Режим приостановки — это состояние, в котором происходит наибольшая экономия энергии, но сохраняются все рабочие данные и параметры. Содержимое памяти произвольного доступа (ОЗУ) сохраняется, но многие устройства, скорее всего, будут отключены.

Требования

Требование Значение
Минимальная версия клиента
Windows XP [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Заголовок
WinUser.h (включая Windows.h)

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

WM_POWERBROADCAST