SYSTEM_POWER_STATUS Struktur (winbase.h)

Artikel
08/27/2023

Enthält Informationen zur status des Systems.

Syntax

typedef struct _SYSTEM_POWER_STATUS {
  BYTE  ACLineStatus;
  BYTE  BatteryFlag;
  BYTE  BatteryLifePercent;
  BYTE  SystemStatusFlag;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;

Member

ACLineStatus

Die netzstrom-status. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
0	Offline
1	Online
255	Status „Unbekannt“

BatteryFlag

Die Akkuladung status. Dieses Element kann mindestens eins der folgenden Flags enthalten.

Wert	Bedeutung
1	Hoch – die Akkukapazität liegt bei mehr als 66 Prozent.
2	Niedrig – die Akkukapazität beträgt weniger als 33 Prozent.
4	Kritisch: Die Akkukapazität liegt unter fünf Prozent.
8	Aufladen
128	Kein Systemakku
255	Unbekannter status– Die Informationen zum Akkuflaggen können nicht gelesen werden.

Der Wert ist 0, wenn der Akku nicht geladen wird und die Akkukapazität zwischen niedrig und hoch liegt.

BatteryLifePercent

Der Prozentsatz der verbleibenden Akkuladung. Dieser Member kann ein Wert im Bereich von 0 bis 100 oder 255 sein, wenn status unbekannt ist.

SystemStatusFlag

Die status des Akkusparmodus. Um an der Energieeinsparung teilzunehmen, vermeiden Sie ressourcenintensive Aufgaben, wenn der Akkusparmodus aktiviert ist. Um benachrichtigt zu werden, wenn sich dieser Wert ändert, rufen Sie die Funktion RegisterPowerSettingNotification mit der GUID für die Energieeinstellungauf, GUID_POWER_SAVING_STATUS.

Wert	Bedeutung
0	Der Akkusparmodus ist deaktiviert.
1	Akkusparmodus aktiviert. Energie sparen, wo es möglich ist.

Hinweis Dieses Flag und die GUID_POWER_SAVING_STATUS GUID wurden in Windows 10 eingeführt. Dieses Flag war zuvor reserviert und hatte den Wert 0.

Allgemeine Informationen zum Akkusparmodus finden Sie unter Akkusparmodus (in den Richtlinien für Hardwarekomponenten).

BatteryLifeTime

Die Anzahl der verbleibenden Sekunden der Akkulaufzeit oder –1, wenn die verbleibenden Sekunden unbekannt sind oder wenn das Gerät an den Netzstrom angeschlossen ist.

BatteryFullLifeTime

Die Anzahl der Sekunden der Akkulaufzeit bei vollständiger Aufladung oder –1, wenn die volle Akkulaufzeit unbekannt ist oder wenn das Gerät an den Netzstrom angeschlossen ist.

Hinweise

Das System ist nur in der Lage , BatteryFullLifeTime basierend auf Berechnungen für BatteryLifeTime und BatteryLifePercent zu schätzen. Ohne Intelligente Batteriesubsysteme ist dieser Wert möglicherweise nicht genau genug, um nützlich zu sein.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winbase.h (einschließlich Windows.h)

Weitere Informationen

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

Energiesparmodus (in den Richtlinien für Hardwarekomponenten)

Share via