WM_POWERBROADCAST-Meldung

  • Artikel

Informiert Anwendungen, dass ein Power-Management-Ereignis aufgetreten ist.

Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.

LRESULT CALLBACK WindowProc(
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWERBROADCAST
  WPARAM wParam,  // power-management event
  LPARAM lParam   // function-specific data
);

Parameter

hwnd

Ein Handle zum Fenster.

uMsg

Wert Bedeutung
WM_POWERBROADCAST
536 (0x218)
 Meldungsbezeichner.

wParam

Das Power-Management-Ereignis. Dieser Parameter kann einen der folgenden Werte annehmen.

Ereignis Bedeutung
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Der Energiestatus hat sich geändert.
PBT_APMRESUMEAUTOMATIC
18 (0x12)
 Der Betrieb wird automatisch aus einem Energiesparzustand fortgesetzt. Diese Meldung wird jedes Mal gesendet, wenn das System fortgesetzt wird.
PBT_APMRESUMESUSPEND
7 (0x7)
 Der Betrieb wird aus einem Energiesparzustand fortgesetzt. Diese Meldung wird nach PBT_APMRESUMEAUTOMATIC gesendet, wenn die Fortsetzung durch Benutzereingaben ausgelöst wird, z. B. durch Drücken einer Taste.
PBT_APMSUSPEND
4 (0x4)
 Das System unterbricht den Betrieb.
PBT_POWERSETTINGCHANGE
32787 (0x8013)
 Es wurde ein Ereignis bezüglich einer Änderung der Energieeinstellung empfangen.

lParam

Die ereignisspezifischen Daten. Für die meisten Ereignisse ist dieser Parameter reserviert und wird nicht verwendet.

Wenn der Parameter wParamPBT_POWERSETTINGCHANGE ist, ist der Parameter lParam ein Zeiger auf eine POWERBROADCAST_SETTING-Struktur.

Rückgabewert

Eine Anwendung sollte TRUE zurückgeben, wenn sie diese Meldung verarbeitet.

Hinweise

Das System sendet immer eine PBT_APMRESUMEAUTOMATIC-Meldung, wenn das System fortgesetzt wird. Wenn das System als Reaktion auf Benutzereingaben wie das Drücken einer Taste fortgesetzt wird, sendet das System auch eine PBT_APMRESUMESUSPEND-Meldung nach dem Senden von PBT_APMRESUMEAUTOMATIC.

WM_POWERBROADCAST-Meldungen unterscheiden nicht zwischen verschiedenen Energiesparzuständen. Eine Anwendung kann nur feststellen, dass das System in einen stromsparenden Zustand eintritt oder diesen wieder verlässt; sie kann nicht den spezifischen Energiezustand bestimmen. Das System zeichnet Details über den Wechsel des Energiezustands im Windows System-Ereignisprotokoll auf.

Um zu verhindern, dass das System in Windows Vista in einen Energiesparzustand wechselt, muss eine Anwendung SetThreadExecutionState aufrufen, um das System darüber zu informieren, dass es verwendet wird.

Die folgenden Meldungen werden auf keinem der im Abschnitt „Anforderungen“ angegebenen Betriebssysteme unterstützt:

  • PBT_APMQUERYSTANDBY
  • PBT_APMQUERYSTANDBYFAILED
  • PBT_APMSTANDBY
  • PBT_APMRESUMESTANDBY

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 (include Windows.h)

Siehe auch