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 |
|