Compartir a través de

mensaje de WM_POWER

  • Artículo

Notifica a las aplicaciones que el sistema, normalmente un equipo personal con batería, está a punto de entrar en modo suspendido.

Nota

El mensaje de WM_POWER está obsoleto. Solo se proporciona por compatibilidad con aplicaciones basadas en Windows de 16 bits. Las aplicaciones deben usar el mensaje WM_POWERBROADCAST .

Una ventana recibe este mensaje a través de su función WindowProc .

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

Parámetros

hwnd

Identificador de la ventana.

uMsg

Identificador de mensaje WM_POWER .

wParam

Notificación de eventos de energía. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
PWR_CRITICALRESUME
 Indica que el sistema está reanudando la operación después de entrar en modo suspendido sin difundir primero un mensaje de notificación PWR_SUSPENDREQUEST a la aplicación. Una aplicación debe realizar las acciones de recuperación necesarias.
PWR_SUSPENDREQUEST
 Indica que el sistema está a punto de entrar en modo suspendido.
PWR_SUSPENDRESUME
 Indica que el sistema está reanudando la operación después de haber entrado en modo suspendido normalmente es decir, el sistema difunde un mensaje de notificación PWR_SUSPENDREQUEST a la aplicación antes de que se suspendiera el sistema. Una aplicación debe realizar las acciones de recuperación necesarias.

lParam

Este parámetro no se utiliza.

Valor devuelto

El valor que devuelve una aplicación depende del valor del parámetro wParam . Si wParam es PWR_SUSPENDREQUEST, el valor devuelto se PWR_FAIL para evitar que el sistema entre en el estado suspendido; de lo contrario, es PWR_OK. Si wParam es PWR_SUSPENDRESUME o PWR_CRITICALRESUME, el valor devuelto es cero.

Comentarios

Este mensaje se transmite solo a una aplicación que se ejecuta en un sistema que se ajusta a la especificación básica del sistema de entrada y salida (BIOS) de administración avanzada de energía (APM). El controlador de administración de energía transmite el mensaje a cada ventana devuelta por la función EnumWindows .

El modo suspendido es el estado en el que se produce la mayor cantidad de ahorro de energía, pero se conservan todos los datos y parámetros operativos. El contenido de memoria de acceso aleatorio (RAM) se conserva, pero es probable que muchos dispositivos se desactiven.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
WinUser.h (incluye Windows.h)

Consulte también

WM_POWERBROADCAST