WM_POWER Nachricht

Benachrichtigt Anwendungen, dass das System, in der Regel ein akkubetriebener Pc, in einen angehaltenen Modus wechselt.

Hinweis

Die WM_POWER Nachricht ist veraltet. Es wird nur zur Kompatibilität mit 16-Bit-Windows-basierten Anwendungen bereitgestellt. Anwendungen sollten die meldung WM_POWERBROADCAST verwenden.

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

LRESULT CALLBACK WindowProc
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWER
  WPARAM wParam,  // power-event notification
  LPARAM lParam   // not used
); 

Parameter

hwnd

Ein Handle zum Fenster.

uMsg

Der WM_POWER Nachrichtenbezeichner.

wParam

Die Energieereignisbenachrichtigung. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
PWR_CRITICALRESUME
Gibt an, dass der Systembetrieb nach dem Wechsel in den angehaltenen Modus fortgesetzt wird, ohne zuerst eine PWR_SUSPENDREQUEST Benachrichtigung an die Anwendung zu senden. Eine Anwendung sollte alle erforderlichen Wiederherstellungsaktionen ausführen.
PWR_SUSPENDREQUEST
Gibt an, dass das System in den angehaltenen Modus wechselt.
PWR_SUSPENDRESUME
Gibt an, dass das System den Vorgang fortsetzen wird, nachdem er in den angehaltenen Modus gewechselt wurde, d. h. das System sendet eine PWR_SUSPENDREQUEST Benachrichtigung an die Anwendung, bevor das System angehalten wurde. Eine Anwendung sollte alle erforderlichen Wiederherstellungsaktionen ausführen.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Der Wert, den eine Anwendung zurückgibt, hängt vom Wert des wParam-Parameters ab. Wenn wParamPWR_SUSPENDREQUEST ist, wird der Rückgabewert PWR_FAIL , um zu verhindern, dass das System in den angehaltenen Zustand wechselt. andernfalls ist es PWR_OK. Wenn wParamPWR_SUSPENDRESUME oder PWR_CRITICALRESUME ist, ist der Rückgabewert null.

Bemerkungen

Diese Meldung wird nur an eine Anwendung gesendet, die auf einem System ausgeführt wird, das der BIOS-Spezifikation (Advanced Power Management) entspricht. Die Nachricht wird vom Energieverwaltungstreiber an jedes Fenster gesendet, das von der EnumWindows-Funktion zurückgegeben wird.

Der Angehaltene Modus ist der Zustand, in dem die größte Energieeinsparung auftritt, aber alle Betriebsdaten und Parameter beibehalten werden. Ram-Inhalte (Random Access Memory) bleiben erhalten, aber viele Geräte sind wahrscheinlich deaktiviert.

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 (windows.h einschließen)

Siehe auch

WM_POWERBROADCAST