WM_POWER mensagem

Notifica os aplicativos de que o sistema, normalmente um computador pessoal alimentado por bateria, está prestes a entrar em um modo suspenso.

Observação

A mensagem WM_POWER está obsoleta. Ele é fornecido apenas para compatibilidade com aplicativos baseados no Windows de 16 bits. Os aplicativos devem usar a mensagem WM_POWERBROADCAST .

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

Um identificador para janela.

uMsg

O identificador de mensagem WM_POWER .

wParam

A notificação de evento de energia. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
PWR_CRITICALRESUME
Indica que o sistema está retomando a operação depois de entrar no modo suspenso sem primeiro transmitir uma mensagem de notificação PWR_SUSPENDREQUEST para o aplicativo. Um aplicativo deve executar as ações de recuperação necessárias.
PWR_SUSPENDREQUEST
Indica que o sistema está prestes a entrar no modo suspenso.
PWR_SUSPENDRESUME
Indica que o sistema está retomando a operação depois de ter entrado no modo suspenso normalmente, ou seja, o sistema transmitiu uma mensagem de notificação PWR_SUSPENDREQUEST para o aplicativo antes de o sistema ser suspenso. Um aplicativo deve executar as ações de recuperação necessárias.

lParam

Este parâmetro não é usado.

Valor retornado

O valor retornado por um aplicativo depende do valor do parâmetro wParam . Se wParam for PWR_SUSPENDREQUEST, o valor retornado será PWR_FAIL para impedir que o sistema entre no estado suspenso; caso contrário, será PWR_OK. Se wParam for PWR_SUSPENDRESUME ou PWR_CRITICALRESUME, o valor retornado será zero.

Comentários

Essa mensagem é transmitida somente para um aplicativo em execução em um sistema que está em conformidade com a especificação básica do BIOS (sistema de entrada/saída) do APM (Gerenciamento Avançado de Energia). A mensagem é transmitida pelo driver de gerenciamento de energia para cada janela retornada pela função EnumWindows .

O modo suspenso é o estado em que ocorre a maior quantidade de economia de energia, mas todos os dados e parâmetros operacionais são preservados. O conteúdo da memória de acesso aleatório (RAM) é preservado, mas muitos dispositivos provavelmente serão desativados.

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 (inclua Windows.h)

Confira também

WM_POWERBROADCAST