Compartir a través de

Evento PBT_APMPOWERSTATUSCHANGE

  • Artículo

Notifica a las aplicaciones un cambio en el estado de energía del equipo, como un cambio de la energía de la batería a A/C. El sistema también difunde este evento cuando el resto de la energía de la batería cae por debajo del umbral especificado por el usuario o si la energía de la batería cambia en un porcentaje especificado.

Una ventana recibe este evento a través del mensaje WM_POWERBROADCAST. Los parámetros wParam y lParam se establecen como se describe a continuación.

LRESULT 
CALLBACK 
WindowProc( HWND hwnd,      // handle to window
            UINT uMsg,      // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMPOWERSTATUSCHANGE
            LPARAM lParam); // zero

Parámetros

hwnd

Identificador de ventana.

uMsg

Value Significado
WM_POWERBROADCAST
536 (0x218)
 Identificador de mensaje.

wParam

Value Significado
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Identificador de evento.

lParam

Reservado; debe ser cero.

Valor devuelto

No devuelve ningún valor.

Comentarios

Una aplicación debe procesar este evento llamando a la función GetSystemPowerStatus para recuperar el estado de energía actual del equipo. En concreto, la aplicación debe comprobar los miembros ACLineStatus, BatteryFlag, BatteryLifeTime y BatteryLifePercent de la estructura SYSTEM_POWER_STATUS para ver los cambios. Este evento puede producirse cuando la duración de la batería cae a menos de 5 minutos o cuando el porcentaje de duración de la batería cae por debajo del 10 por ciento, o si la duración de la batería cambia un 3 por ciento.

Requisitos

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

Consulte también