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
);
-
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.
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.
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.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
Header |
|