WM_POWERBROADCAST messaggio

  • Articolo

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

Valore Significato
WM_POWERBROADCAST
536 (0x218)
 Identificatore del messaggio.

wParam

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

Evento Significato
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Lo stato dell'alimentazione è cambiato.
PBT_APMRESUMEAUTOMATIC
18 (0x12)
 L'operazione viene ripresa automaticamente da uno stato a basso consumo. Questo messaggio viene inviato ogni volta che il sistema riprende.
PBT_APMRESUMESUSPEND
7 (0x7)
 L'operazione riprende da uno stato a basso consumo. Questo messaggio viene inviato dopo PBT_APMRESUMEAUTOMATIC se il curriculum viene attivato dall'input dell'utente, ad esempio premendo un tasto.
PBT_APMSUSPEND
4 (0x4)
 Il sistema sta sospendendo l'operazione.
PBT_POWERedizione Standard TTINGCHANGE
32787 (0x8013)
 È stato ricevuto un evento di modifica delle impostazioni di risparmio energia.

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

Requisito Valore
Client minimo supportato
 Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
WinUser.h (include Windows.h)

Vedi anche