mensaje de WM_POWERBROADCAST
Notifica a las aplicaciones que se han producido un evento de administración de energía.
Una ventana recibe este mensaje a través de su función WindowProc .
LRESULT CALLBACK WindowProc(
HWND hwnd, // handle to window
UINT uMsg, // WM_POWERBROADCAST
WPARAM wParam, // power-management event
LPARAM lParam // function-specific data
);
Parámetros
-
Hwnd
-
Identificador de la ventana.
- *uMsg*
-
Valor Significado - WM_POWERBROADCAST
- 536 (0x218)
Identificador de mensaje. -
wParam
-
Evento de administración de energía. Este parámetro puede ser uno de los siguientes identificadores de evento.
Evento Significado - PBT_APMPOWERSTATUSCHANGE
- 10 (0xA)
El estado de energía ha cambiado. - PBT_APMRESUMEAUTOMATIC
- 18 (0x12)
La operación se reanuda automáticamente a partir de un estado de bajo consumo. Este mensaje se envía cada vez que se reanuda el sistema. - PBT_APMRESUMESUSPEND
- 7 (0x7)
La operación se reanuda a partir de un estado de bajo consumo. Este mensaje se envía después de PBT_APMRESUMEAUTOMATIC si la entrada del usuario desencadena la reanudación, como presionar una tecla. - PBT_APMSUSPEND
- 4 (0x4)
El sistema está suspendiendo la operación. - PBT_POWERSETTINGCHANGE
- 32787 (0x8013)
Se ha recibido un evento de cambio de configuración de energía. -
lParam
-
Datos específicos del evento. Para la mayoría de los eventos, este parámetro está reservado y no se usa.
Si el parámetro wParam es PBT_POWERSETTINGCHANGE, el parámetro lParam es un puntero a una estructura de POWERBROADCAST_SETTING .
Valor devuelto
Una aplicación debe devolver TRUE si procesa este mensaje.
Comentarios
El sistema siempre envía un mensaje PBT_APMRESUMEAUTOMATIC cada vez que se reanuda el sistema. Si el sistema se reanuda en respuesta a la entrada del usuario, como presionar una tecla, el sistema también envía un mensaje de PBT_APMRESUMESUSPEND después de enviar PBT_APMRESUMEAUTOMATIC.
WM_POWERBROADCAST los mensajes no distinguen entre diferentes estados de baja potencia. Una aplicación solo puede determinar que el sistema entra o se ha reanudado desde un estado de bajo consumo; no puede determinar el estado de energía específico. El sistema registra detalles sobre las transiciones de estado de energía en el registro de eventos del sistema de Windows.
Para evitar que el sistema pase a un estado de baja potencia en Windows Vista, una aplicación debe llamar a SetThreadExecutionState para informar al sistema de que está en uso.
Los mensajes siguientes no se admiten en ninguno de los sistemas operativos especificados en la sección Requisitos:
- PBT_APMQUERYSTANDBY
- PBT_APMQUERYSTANDBYFAILED
- PBT_APMSTANDBY
- PBT_APMRESUMESTANDBY
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 |
|