Mensagem WM_POWERBROADCAST

Notifica os aplicativos sobre a ocorrência de um evento de gerenciamento de energia.

Uma janela recebe essa mensagem por meio da sua função 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

Uma alça para a janela.

uMsg

wParam

O evento de gerenciamento de energia. Esse parâmetro pode ser um dos seguintes identificadores de evento.

lParam

Os dados específicos do evento. Para a maioria dos eventos, esse parâmetro é reservado e não é utilizado.

Se o parâmetro wParam for PBT_POWERSETTINGCHANGE, o parâmetro lParam será um ponteiro para uma estrutura POWERBROADCAST_SETTING.

Valor retornado

Um aplicativo deve retornar TRUE se processar essa mensagem.

Comentários

O sistema sempre envia uma mensagem PBT_APMRESUMEAUTOMATIC sempre que o sistema é retomado. Se o sistema for retomado em resposta à entrada do usuário, como pressionar uma tecla, o sistema também enviará uma mensagem PBT_APMRESUMESUSPEND depois de enviar PBT_APMRESUMEAUTOMATIC.

As mensagens WM_POWERBROADCAST não fazem distinção entre os diferentes estados de baixo consumo de energia. Um aplicativo pode determinar apenas que o sistema está entrando ou saiu de um estado de baixo consumo de energia; ele não pode determinar o estado de energia específico. O sistema registra detalhes sobre as transições de estado de energia no log de eventos do Sistema Windows.

Para evitar que o sistema faça a transição para um estado de baixo consumo de energia no Windows Vista, um aplicativo deve chamar SetThreadExecutionState para informar ao sistema que está em uso.

As mensagens a seguir não têm suporte em nenhum dos sistemas operacionais especificados na seção Requisitos:

• PBT_APMQUERYSTANDBY
• PBT_APMQUERYSTANDBYFAILED
• PBT_APMSTANDBY
• PBT_APMRESUMESTANDBY

Requisitos

Confira também

• Mensagens WM_POWERBROADCAST
• Mensagens de Gerenciamento de Energia
• RegisterSuspendResumeNotification