PBT _ APMPOWERSTATUSCHANGE-Ereignis

Benachrichtigt Anwendungen über eine Änderung des Energiestatus des Computers, z. B. einen Wechsel vom Akkustrom zu A/C. Das System leitet dieses Ereignis auch dann weiter, wenn die verbleibende Akkuleistung unter einen vom Benutzer festgelegten Wert sinkt oder sich um einen angegebenen Prozentsatz ändert.

Ein Fenster empfängt dieses Ereignis über die WM _ POWERBROADCAST-Nachricht. Die Parameter wParam und lParam werden wie folgt festgelegt.

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

Parameter

Hwnd

Ein Handle für ein Fenster.

*uMsg*
Wert Bedeutung
WM _ POWERBROADCAST
536 (0x218)
Nachrichtenbezeichner.
*wParam*
Wert Bedeutung
PBT _ APMPOWERSTATUSCHANGE
10 (0xA)
Ereignisbezeichner.

lParam

Reserviert; muss 0 (null) sein.

Rückgabewert

Kein Rückgabewert.

Hinweise

Eine Anwendung sollte dieses Ereignis verarbeiten, indem sie die GetSystemPowerStatus-Funktion aufruft, um den aktuellen Energiestatus des Computers abzurufen. Insbesondere sollte die Anwendung die Member ACLineStatus, BatteryFlag, BatteryLifeTime und BatteryLifePercent der SYSTEM POWER _ _ STATUS-Struktur auf Änderungen überprüfen. Dieses Ereignis kann auftreten, wenn die Akkulebensdauer auf weniger als 5 Minuten sinkt, der Prozentsatz der Akkulebensdauer unter 10 Prozent fällt oder sich die Akkulebensdauer um 3 Prozent ändert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
WinUser.h (include Windows.h)

Siehe auch

Systemleistungsstatus

Energieverwaltungsereignisse

GetSystemPowerStatus

_ _ SYSTEMLEISTUNGSSTATUS

WM _ POWERBROADCAST