evento PBT_APMPOWERSTATUSCHANGE

  • Articolo

Notifica alle applicazioni una modifica dello stato di alimentazione del computer, ad esempio un commutatore dalla batteria all'A/C. Il sistema trasmette questo evento anche quando la batteria rimanente scivola al di sotto della soglia specificata dall'utente o se l'alimentazione della batteria cambia di una percentuale specificata.

Una finestra riceve questo evento tramite il messaggio di WM_POWERBROADCAST . I parametri wParam e lParam vengono impostati come descritto di seguito.

LRESULT 
CALLBACK 
WindowProc( HWND hwnd,      // handle to window
            UINT uMsg,      // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMPOWERSTATUSCHANGE
            LPARAM lParam); // zero

Parametri

hwnd

Handle per la finestra.

Umsg

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

wParam

Valore Significato
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Identificatore dell'evento.

lParam

Riservati; deve essere zero.

Valore restituito

Nessun valore restituito.

Osservazioni:

Un'applicazione deve elaborare questo evento chiamando la funzione GetSystemPowerStatus per recuperare lo stato di alimentazione corrente del computer. In particolare, l'applicazione deve controllare i membri ACLineStatus, BatteryFlag, BatteryLifeTime e BatteryLifePercent della struttura SYSTEM_POWER_STATUS per eventuali modifiche. Questo evento può verificarsi quando la durata della batteria scende a meno di 5 minuti o quando la percentuale di durata della batteria scende al di sotto del 10% o se la durata della batteria cambia del 3%.

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