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)

Weitere Informationen

CallNtPowerInformation