WM_POWERBROADCAST messaggio

Notifica alle applicazioni che si è verificato un evento di risparmio energia.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

LRESULT CALLBACK WindowProc(
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWERBROADCAST
  WPARAM wParam,  // power-management event
  LPARAM lParam   // function-specific data
);

Parametri

hwnd

Handle per la finestra.

Umsg

wParam

Evento di risparmio energia. Questo parametro può essere uno degli identificatori di evento seguenti.

lParam

Dati specifici dell'evento. Per la maggior parte degli eventi, questo parametro è riservato e non usato.

Se il parametro wParam è PBT_POWERedizione Standard TTINGCHANGE, il parametro lParam è un puntatore a una struttura POWERBROADCAST_edizione Standard TTING.

Valore restituito

Un'applicazione deve restituire TRUE se elabora questo messaggio.

Osservazioni:

Il sistema invia sempre un messaggio di PBT_APMRESUMEAUTOMATIC ogni volta che il sistema riprende. Se il sistema riprende in risposta all'input dell'utente, ad esempio premendo un tasto, il sistema invia anche un messaggio di PBT_APMRESUMESUSPEND dopo l'invio di PBT_APMRESUMEAUTOMATIC .

WM_POWERBROADCAST messaggi non distinguono i diversi stati a basso consumo. Un'applicazione può determinare solo che il sistema sta immettendo o ha ripreso da uno stato a basso consumo; non è in grado di determinare lo stato di alimentazione specifico. Il sistema registra i dettagli sulle transizioni di stato di alimentazione nel registro eventi di sistema di Windows.

Per evitare che il sistema passi a uno stato a basso consumo in Windows Vista, un'applicazione deve chiamare SetThreadExecutionState per informare il sistema che è in uso.

I messaggi seguenti non sono supportati in nessuno dei sistemi operativi specificati nella sezione Requisiti:

• PBT_APMQUERYSTANDBY
• PBT_APMQUERYSTANDBYFAILED
• PBT_APMSTANDBY
• PBT_APMRESUMESTANDBY

Requisiti

Vedi anche

• messaggi WM_POWERBROADCAST
• Messaggi di risparmio energia
• RegisterSuspendResumeNotification