PBT_APMPOWERSTATUSCHANGE-Ereignis

  • Artikel

Benachrichtigt Anwendungen über eine Änderung des Energiestatus des Computers, z. B. einen Wechsel von Akkubetrieb zu Netzbetrieb. Das System überträgt dieses Ereignis, wenn der Ladezustand des Akkus unter den benutzerseitig angegebenen Schwellenwert fällt oder sich der Ladezustand um einen bestimmten 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 zum Fenster.

uMsg

Wert Bedeutung
WM_POWERBROADCAST
536 (0x218)
 Nachrichtenbezeichner.

wParam

Wert Bedeutung
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Ereignisbezeichner.

lParam

Reserviert: Muss 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 Akkulaufzeit auf weniger als 5 Minuten sinkt, der Prozentsatz der Akkulaufzeit unter 10 Prozent fällt oder sich die Akkulaufzeit um 3 Prozent ändert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
WinUser.h (einschließlich Windows.h)

Siehe auch