Energieeinstellungs-GUIDs
Die Energieeinstellungs-GUIDs identifizieren Energieänderungsereignisse. In diesem Artikel werden die Energieeinstellungs-GUIDs für Benachrichtigungen aufgeführt, die für Anwendungen am hilfreichsten sind. Eine Anwendung sollte sich für jedes Energieänderungsereignis registrieren, das sich auf ihr Verhalten auswirken könnte. Jedes Mal, wenn sich eine Einstellung ändert, wird eine Benachrichtigung gesendet.
Die Energieeinstellungs-GUIDs sind in WinNT.h definiert.
GUID_ACDC_POWER_SOURCE (5D3E9A59-E9D5-4B00-A6BD-FF34FF516548)
Die Stromquelle des Systems hat sich geändert.
Der Data-Member ist ein DWORD mit einem Wert aus der SYSTEM_POWER_CONDITION-Enumeration, die die aktuelle Stromquelle angibt:
PoAc (0): Der Computer wird über eine Wechselstromquelle (oder eine ähnliche Quelle wie ein 12-V-Automobiladapter für einen Laptop) mit Energie versorgt.
PoDc (1): Der Computer wird über eine integrierte Akkustromquelle mit Energie versorgt.
PoHot (2): Der Computer wird über eine kurzfristige Stromquelle wie ein UPS-Gerät mit Energie versorgt.
GUID_BATTERY_PERCENTAGE_REMAINING (A7AD8041-B45A-4CAE-87A3-EECBB468A9E1)
Die verbleibende Akkukapazität hat sich geändert. Die Granularität variiert von System zu System, die feinste Granularität beträgt jedoch ein Prozent.
Der Data-Member ist ein DWORD, das die aktuell verbleibende Akkukapazität als Prozent von 0 bis 100 angibt.
GUID_CONSOLE_DISPLAY_STATE (6FE69556-704A-47A0-8F24-C28D936FDA47)
Der Anzeigestatus des aktuellen Monitors hat sich geändert.
Windows 7, Windows Server 2008 R2, Windows Vista und Windows Server 2008: Diese Benachrichtigung ist ab Windows 8 und Windows Server 2012 verfügbar.
Der Data-Member ist ein DWORD mit einem Wert aus der MONITOR_DISPLAY_STATE-Enumeration:
PowerMonitorOff (0): Die Anzeige ist deaktiviert.
PowerMonitorOn (1): Die Anzeige ist aktiviert.
PowerMonitorDim (2): Die Anzeige ist gedimmt.
GUID_GLOBAL_USER_PRESENCE (786E8A1D-B427-4344-9207-09E70BDCBEA9)
Der einer beliebigen Sitzung zugeordnete Benutzerstatus hat sich geändert. Dadurch wird der kombinierte Status der Benutzerpräsenz in allen lokalen Sitzungen und Remotesitzungen auf dem System dargestellt.
Diese Benachrichtigung wird nur Diensten und andere Programmen gesendet, die in der Sitzung 0 ausgeführt werden. Anwendungen im Benutzermodus sollten sich stattdessen für GUID_SESSION_USER_PRESENCE registrieren.
Windows 7, Windows Server 2008 R2, Windows Vista und Windows Server 2008: Diese Benachrichtigung ist ab Windows 8 und Windows Server 2012 verfügbar.
Der Data-Member ist ein DWORD mit einem der folgenden Werte aus der USER_ACTIVITY_PRESENCE-Enumeration:
PowerUserPresent (0): Der oder die Benutzer*in ist in einer lokalen Sitzung oder Remotesitzung auf dem System vorhanden.
PowerUserInactive (2): Der oder die Benutzer*in ist in keiner lokalen Sitzung oder Remotesitzung auf dem System vorhanden.
GUID_IDLE_BACKGROUND_TASK (515C31D8-F734-163D-A0FD-11A08C91E8F1)
Das System ist ausgelastet. Das deutet darauf hin, dass das System in naher Zukunft nicht in den Leerlaufbetrieb wechselt und dass Komponenten zu diesem Zeitpunkt Hintergrund- oder Leerlaufaufgaben ausgeführt werden sollten, die einen Wechsel des Computers in den Leerlaufbetrieb verhindern würden.
Es gibt keine Benachrichtigung, wenn das System in den Leerlaufbetrieb wechseln kann. Die Benachrichtigung für Hintergrundaufgaben im Leerlaufbetreib gibt nicht an, ob ein*e Benutzer*in auf dem Computer aktiv ist.
Der Data-Member enthält keine Informationen und kann ignoriert werden.
GUID_LIDSWITCH_STATE_CHANGE (BA3E0F4D-B817-4094-A2D1-D56379E6A0F3)
Der Status des Deckels hat sich geändert (auf- oder zugeklappt). Der Rückruf wird erst aufgerufen, wenn ein zuklappbares Gerät erkannt wird und dessen aktueller Zustand bekannt ist.
0x0: Der Deckel ist zugeklappt.
0x1: Der Deckel ist aufgeklappt.
GUID_MONITOR_POWER_ON (02731015-4510-4526-99E6-E5A17EBD1AEA)
Der primäre Systemmonitor wurde ein- oder ausgeschaltet. Diese Benachrichtigung ist bei Komponenten wie Medienvisualisierungen hilfreich, die Inhalte aktiv auf dem Anzeigegerät rendern. Anwendungen sollten sich für diese Benachrichtigung registrieren und das Rendern von Grafikinhalten beenden, sobald der Monitor ausgeschaltet ist, um den Stromverbrauch des Systems zu senken.
Der Data-Member ist ein DWORD, das den aktuellen Monitorstatus angibt:
0x0: Der Monitor ist ausgeschaltet.
0x1: Der Monitor ist eingeschaltet.
Windows 8 und Windows Server 2012: Neue Anwendungen sollten GUID_CONSOLE_DISPLAY_STATE anstelle dieser Benachrichtigung verwenden.
GUID_POWER_SAVING_STATUS (E00958C0-C213-4ACE-AC77-FECCED2EEEA5)
Der Stromsparmodus wurde nach einer Änderung der Energiebedingungen deaktiviert oder aktiviert. Diese Benachrichtigung ist bei Komponenten hilfreich, die einen Einfluss auf den Energieverbrauch haben. Anwendungen sollten sich bei aktiviertem Stromsparmodus für diese Benachrichtigung registrieren und Energie einsparen.
Der Data-Member ist ein DWORD, das den Status des Stromsparmodus angibt:
0x0: Der Stromsparmodus ist deaktiviert.
0x1: Der Stromsparmodus ist aktiviert. Es wird nach Möglichkeit Energie eingespart.
Allgemeine Informationen zum Stromsparmodus finden Sie unter Stromsparmodus (in den Richtlinien für Hardwarekomponenten).
GUID_ENERGY_SAVER_STATUS (550E8400-E29B-41D4-A716-446655440000)
Wichtig
Diese Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Der Status des Energiesparmodus hat sich geändert. Diese Benachrichtigung ist bei Komponenten hilfreich, die einen Einfluss auf den Energieverbrauch haben. Anwendungen, die sich für diese Benachrichtigung registrieren, können abhängig davon, welche Energiesparmodus wirksam ist, unterschiedliche Leistungsgrade sparen.
Das Data-Mitglied ist ein DWORD mit Werten aus der ENERGY_SAVER_STATUS Enumeration, die den aktuellen Energiesparmodus angeben.
ENERGY_SAVER_OFF – Energiesparmodus ist deaktiviert.
ENERGY_SAVER_STANDARD – Energiesparmodus ist im Standardmodus. Sparen Sie Energie, wenn die Auswirkungen auf die Benutzererfahrung minimal sind.
ENERGY_SAVER_HIGH_SAVINGS – Energiesparmodus ist in hohem Sparmodus. Es wird nach Möglichkeit Energie eingespart.
GUID_POWERSCHEME_PERSONALITY (245D8541-3943-4422-B025-13A784F679B7)
Die Eigenschaften des aktiven Energiesparplans haben sich geändert. Alle Energiesparpläne sind einer dieser Eigenschaften zugeordnet.
Der Data-Member ist eine GUID, die die neuen Eigenschaften des aktiven Energiesparplans angibt:
GUID_MIN_POWER_SAVINGS (8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C)
Höchstleistung: Das Schema soll maximale Leistung auf Kosten der Einsparungen des Energieverbrauchs erzielen.
GUID_MAX_POWER_SAVINGS (A1841308-3541-4FAB-BC81-F71556F20B4A)
Energiesparmodus: Das Schema soll maximale Einsparungen des Energieverbrauchs auf Kosten der Leistung und Reaktionsfähigkeit des Systems erzielen.
GUID_TYPICAL_POWER_SAVINGS (381B4222-F694-41F0-9685-FF5BB260DF2E)
Ausbalanciert: Das Schema soll automatisch einen Ausgleich zwischen Leistung und Stromverbrauch herstellen.
GUID_SESSION_DISPLAY_STATUS (2B84C20E-AD23-4DDF-93DB-05FFBD7EFCA5)
Die der Anwendungssitzung zugeordnete Anzeige wurde ein- oder ausgeschaltet.
Windows 7, Windows Server 2008 R2, Windows Vista und Windows Server 2008: Diese Benachrichtigung ist ab Windows 8 und Windows Server 2012 verfügbar.
Diese Benachrichtigung wird ausschließlich an Benutzermodusanwendungen gesendet. Dienste und andere Programme, die in der Sitzung 0 ausgeführt werden, empfangen diese Benachrichtigung nicht.
Der Data-Member ist ein DWORD mit einem Wert aus der MONITOR_DISPLAY_STATE-Enumeration:
PowerMonitorOff (0): Die Anzeige ist deaktiviert.
PowerMonitorOn (1): Die Anzeige ist aktiviert.
PowerMonitorDim (2): Die Anzeige ist gedimmt.
Hinweis
Alle in einer interaktiven Benutzermodussitzung ausgeführten Anwendungen sollten diese Einstellung verwenden. Kernelmodusanwendungen, sie sich für die Überwachung des Status registrieren, sollten stattdessen GUID_CONSOLE_DISPLAY_STATUS verwenden.
GUID_SESSION_USER_PRESENCE (3C0F4548-C03F-4C4D-B9F2-237EDE686376)
Der der Anwendungssitzung zugeordnete Benutzerstatus hat sich geändert.
Windows 7, Windows Server 2008 R2, Windows Vista und Windows Server 2008: Diese Benachrichtigung ist ab Windows 8 und Windows Server 2012 verfügbar.
Diese Benachrichtigung wird ausschließlich an Anwendungen im Benutzermodus gesendet, die in einer interaktiven Sitzung ausgeführt werden. Dienste und andere Programme, die in der Sitzung 0 ausgeführt werden, sollten sich für GUID_GLOBAL_USER_PRESENCE registrieren.
Der Data-Member ist ein DWORD mit einem der folgenden Werte aus der USER_ACTIVITY_PRESENCE-Enumeration:
PowerUserPresent (0): Der oder die Benutzer*in macht Eingaben in der Sitzung.
PowerUserInactive (2): Das Timeout für die Benutzeraktivität ist aufgrund fehlender Benutzerinteraktion eingetreten.
GUID_SYSTEM_AWAYMODE (98A7F580-01F7-48AA-9C0F-44352C29E5C0)
Das System wechselt in den Abwesenheitsmodus oder verlässt diesen.
Der Data-Member ist ein DWORD, das den aktuellen Status des Abwesenheitsmodus angibt:
0x0: Der Computer verlässt den Abwesenheitsmodus.
0x1: Der Computer wechselt in den Abwesenheitsmodus.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für