Evento PBT_APMPOWERSTATUSCHANGE

  • Artigo

Notifica os aplicativos sobre uma alteração no status de energia do computador, como uma mudança da energia da bateria para CA. O sistema também transmite esse evento quando a energia restante da bateria fica abaixo do limite especificado pelo usuário ou se a energia da bateria for alterada em um percentual especificado.

Uma janela recebe esse evento por meio da mensagem WM_POWERBROADCAST. Os parâmetros wParam e lParam são definidos conforme descrito a seguir.

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

Parâmetros

hwnd

Uma alça para a janela.

uMsg

Valor Significado
WM_POWERBROADCAST
536 (0x218)
 Identificador de mensagem.

wParam

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

lParam

Reservado; deve ser zero.

Valor retornado

Sem valor de retorno.

Comentários

Um aplicativo deve processar esse evento chamando a função GetSystemPowerStatus para recuperar o status atual de energia do computador. Em particular, o aplicativo deve verificar se há alterações nos membros ACLineStatus, BatteryFlag, BatteryLifeTime e BatteryLifePercent da estrutura SYSTEM_POWER_STATUS. Esse evento pode ocorrer quando a duração da bateria cai para menos de 5 minutos, quando a porcentagem de duração da bateria cai para menos de 10% ou quando a duração da bateria é alterada em 3%.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
WinUser.h (incluir o Windows.h)

Confira também