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