SYSTEM_BATTERY_STATE Struktur (winnt.h)
Enthält Informationen zum aktuellen Zustand der Systembatterie.
Syntax
typedef struct {
BOOLEAN AcOnLine;
BOOLEAN BatteryPresent;
BOOLEAN Charging;
BOOLEAN Discharging;
BOOLEAN Spare1[3];
BYTE Tag;
DWORD MaxCapacity;
DWORD RemainingCapacity;
DWORD Rate;
DWORD EstimatedTime;
DWORD DefaultAlert1;
DWORD DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;
Member
AcOnLine
Wenn dieses Element TRUE ist, wird das Systemladegerät derzeit mit externem Strom betrieben.
BatteryPresent
Wenn dieser Member TRUE ist, ist mindestens eine Batterie im System vorhanden.
Charging
Wenn dieses Element TRUE ist, wird derzeit ein Akku aufgeladen.
Discharging
Wenn dieses Element TRUE ist, wird derzeit ein Akku entladen.
Spare1[3]
Reserviert.
Tag
MaxCapacity
Die theoretische Kapazität der Batterie, wenn sie neu ist.
RemainingCapacity
Die geschätzte verbleibende Kapazität des Akkus.
Rate
Die aktuelle Entladungsrate der Batterie in mW. Eine nichtzero positive Rate gibt das Aufladen an; eine negative Rate gibt die Entladung an. Einige Batterien melden nur Entladeraten. Dieser Wert sollte als LONG behandelt werden, da er negative Werte enthalten kann (mit dem hohen Bitsatz).
EstimatedTime
Die geschätzte verbleibende Zeit für den Akku in Sekunden.
DefaultAlert1
Der Hersteller empfiehlt eine Kapazität in mWh, bei der eine Warnung mit niedrigem Akkustand auftreten sollte. Die Definitionen von niedrig variieren von Hersteller zu Hersteller. Im Allgemeinen tritt ein Warnzustand vor einem niedrigen Zustand auf, aber Sie sollten nicht davon ausgehen, dass dies immer der Vorgang ist. Um das Risiko eines Datenverlusts zu verringern, wird dieser Wert in der Regel als Standardeinstellung für den kritischen Batteriealarm verwendet.
DefaultAlert2
Der Hersteller empfiehlt eine Kapazität in mWh, bei der eine Warnbatteriewarnung auftreten sollte. Die Definitionen von Warnungen variieren von Hersteller zu Hersteller. Im Allgemeinen tritt ein Warnzustand vor einem niedrigen Zustand auf, aber Sie sollten nicht davon ausgehen, dass dies immer der Vorgang ist. Um das Risiko eines Datenverlusts zu verringern, wird dieser Wert in der Regel als Standardeinstellung für den Batteriealarm verwendet.
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Kopfzeile | winnt.h (Einschließen von Windows.h) |