Share via

BATTERY_STATUS Struktur

  • Artikel

Enthält den aktuellen Zustand der Batterie. Diese Struktur wird vom IOCTL_BATTERY_QUERY_STATUS-Steuerelementcode verwendet.

Syntax

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

Member

PowerState

Der Akkuzustand. Dieser Member kann null, ein oder mehrere der folgenden Werte sein.

Wert Bedeutung
BATTERY_CHARGING
0x00000004
 Gibt an, dass der Akku gerade aufgeladen wird.
BATTERY_CRITICAL
0x00000008
 Gibt an, dass ein Akkuausfall unmittelbar bevorsteht. Weitere Informationen finden Sie im Abschnitt Hinweise.
BATTERY_DISCHARGING
0x00000002
 Gibt an, dass der Akku gerade entladen wird.
BATTERY_POWER_ON_LINE
0x00000001
 Gibt an, dass das System Zugriff auf Netzstrom hat, sodass keine Batterien entladen werden.

Capacity

Die aktuelle Akkukapazität in mWh (oder relativ). Dieser Wert kann verwendet werden, um eine "Gasmessgerät"-Anzeige zu generieren, indem sie durch das FullChargedCapacity-Element der BATTERY_INFORMATION-Struktur dividiert wird. Wenn die Kapazität nicht verfügbar ist, wird dieser Member BATTERY_UNKNOWN_CAPACITY.

Spannung

Die aktuelle Batteriespannung über die Batterieklemmen, in Millivolt (mv). Wenn die Spannung nicht verfügbar ist, wird dieser Member BATTERY_UNKNOWN_VOLTAGE.

Rate

Die aktuelle Lade- oder Entladungsrate des Akkus. Dieser Wert ist in Milliwatt, es sei denn, die Akkurateninformationen sind relativ, in diesem Fall wird er in beliebigen Einheiten pro Stunde angegeben. Um zu ermitteln, ob Akkuinformationen relativ sind, untersuchen Sie das BATTERY_CAPACITY_RELATIVE-Flag im Capabilities-Member der BATTERY_INFORMATION-Struktur . Eine nichtzero positive Rate gibt das Aufladen an; eine negative Rate gibt die Entladung an. Einige Batterien melden nur Entladungsraten. Wenn die Rate nicht verfügbar ist, wird dieser Member BATTERY_UNKNOWN_RATE. Wenn sich der Zustand des Akkus oder der Stromquelle ändert, wird die Rate möglicherweise verfügbar.

Bemerkungen

Das BATTERY_CRITICAL-Flag im PowerState-Member dieser Struktur weist auf eine hardwarekritische "batteriekritische" Bedingung hin. Diese kritische Ebene wird vom Batteriehersteller festgelegt, nicht vom Benutzer im "Kritischen Batteriealarm". Dies bedeutet im Allgemeinen, dass das Batteriesystem berechnet hat, dass der Akku vollständig entladen ist und die gezogene Leistung über das erwartete Maß hinausgeht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Poclass.h;
Batclass.h unter Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP

Siehe auch

BATTERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS