Win32 API. Структуры и сообщения окна - Сообщение WM_POWER

Сообщение WM_POWER

Сообщение WM_POWER посылается тогда, когда система, обычно персональный компьютер c батарейным питанием, собирается вводить режим приостановки работы. Сообщение WM_POWER устаревшее. Оно предусматривается, чтобы упростить переносимость 16-разрядных прикладных программ базирующихся на Windows. Новые базирующиеся на Win32 прикладные программы должны использовать сообщение WM_POWERBROADCAST.

Синтаксис

 
WM_POWER 
fwPowerEvt = wParam; // уведомительное сообщение о понижении питания 

Параметры

fwPowerEvt
Значение wParam. Определяет уведомительное сообщение о понижении питания. Этот параметр может быть одно из следующих значений:

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

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

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

Замечания

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

Смотри также EnumWindows, WM_POWERBROADCAST

Размещение и совместимость WM_POWER

Windows NT  Да 
Win95   Да 
Win32s   Да 
Импортируемая библиотека -
Заголовочный файл  winuser.h 
Unicode   Нет 
Замечания по платформе Не имеется