BATTERY_INFORMATION Struktur

Artikel
06/12/2023

Enthält Akkuinformationen. Diese Struktur wird vom IOCTL_BATTERY_QUERY_INFORMATION-Steuerungscode zurückgegeben, wenn die BatteryInformation-Informationsebene angefordert wird.

Syntax

typedef struct _BATTERY_INFORMATION {
  ULONG Capabilities;
  UCHAR Technology;
  UCHAR Reserved[3];
  UCHAR Chemistry[4];
  ULONG DesignedCapacity;
  ULONG FullChargedCapacity;
  ULONG DefaultAlert1;
  ULONG DefaultAlert2;
  ULONG CriticalBias;
  ULONG CycleCount;
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;

Member

Capabilities

Die Akkufunktionen. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
BATTERY_CAPACITY_RELATIVE 0x40000000	Gibt an, dass die Informationen zur Akkukapazität und -rate relativ und nicht in bestimmten Einheiten sind. Wenn dieses Bit nicht festgelegt ist, sind die Berichtseinheiten Milliwattstunden (mWh) für Kapazität und Milliwatt (mW) für die Rate. Wenn dieses Bit festgelegt ist, können alle Verweise auf Einheiten in der anderen Batteriedokumentation ignoriert werden. Alle Tarifinformationen werden in Einheiten pro Stunde gemeldet. Wenn beispielsweise die voll aufgeladene Kapazität als 100 gemeldet wird, gibt eine Rate von 200 an, dass der Akku seine gesamte Kapazität in einer halben Stunde auslastet.
BATTERY_IS_SHORT_TERM 0x20000000	Gibt an, dass der normale Vorgang für eine fehlersichere Funktion gilt. Wenn dieses Bit nicht festgelegt ist, wird erwartet, dass der Akku während der normalen Systemnutzung verwendet wird.
BATTERY_SET_CHARGE_SUPPORTED 0x00000001	Gibt an, dass festgelegte Informationsanforderungen des Typs BatteryCharge von diesem Akkugerät unterstützt werden.
BATTERY_SET_DISCHARGE_SUPPORTED 0x00000002	Gibt an, dass festgelegte Informationsanforderungen des Typs BatteryDischarge von diesem Akkugerät unterstützt werden.
BATTERY_SYSTEM_BATTERY 0x80000000	Gibt an, dass der Akku allgemeine Energie bereitstellen kann, um das System auszuführen.

Technologie

Die Batterietechnologie. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
0	Nicht aufladbarer Akku, z. B. Alkali.
1	Wiederaufladbarer Akku, z. B. Bleisäure.

Reserved

Reserviert.

Chemie

Eine abgekürzte Zeichenfolge, die die Chemie der Batterie angibt. Diese Zeichenfolge ist nicht unbedingt 0-endend. Im Folgenden finden Sie eine partielle Liste der zurückzugebenden Abkürzungen und der zugehörigen Chemie.

Unicode-Zeichenfolge	Bedeutung
PbAc	Bleisäure
LÖWE	Lithium-Ionen
Li-I	Lithium-Ionen
Nicd	Nickel-Cadmium
Nimh	Nickelmetallhydrid
Nizn	Nickel Zink
RAM	Wiederaufladbare Alkaline-Manganese

In Zukunft können andere Chemikalien auftreten, und Ihr Code sollte in der Lage sein, sie zu verarbeiten.

DesignedCapacity

Die theoretische Kapazität des Akkus, wenn neu, in mWh, es sei denn, BATTERY_CAPACITY_RELATIVE festgelegt ist. In diesem Fall sind die Einheiten nicht definiert.

FullChargedCapacity

Die aktuelle vollständig geladene Kapazität des Akkus in mWh (oder relativ). Vergleichen Sie diesen Wert mit DesignedCapacity , um den Verschleiß des Akkus zu schätzen.

DefaultAlert1

Die vom Hersteller vorgeschlagene 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

Die vom Hersteller vorgeschlagene Kapazität in mWh, bei der eine Warnung der Batterie 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 normalerweise als Standardeinstellung für den Batteriealarm verwendet.

CriticalBias

Eine Abweichung von null (in mWh), die auf die Batterieberichterstellung angewendet wird. Einige Batterien reservieren eine kleine Ladung, die aus den Kapazitätswerten der Batterie verzerrt ist, um "0" als kritischen Akkustand anzuzeigen. Kritische Verzerrung ist analog zum Festlegen eines Kraftstoffmessgeräts, um "leer" anzuzeigen, wenn mehrere Liter Kraftstoff übrig sind.

CycleCount

Die Anzahl der Lade-/Entladungszyklen, die der Akku erlebt hat. Dies bietet ein Mittel, um den Verschleiß der Batterie zu bestimmen. Wenn der Akku keinen Zykluszähler unterstützt, ist dieser Member 0.

Bemerkungen

Im Allgemeinen tritt ein Warnzustand vor einem niedrigen Zustand auf, aber Sie sollten nicht davon ausgehen, dass dies der Fall ist. Es ist möglich, einen Akku abzufragen und festzustellen, dass keine Warnungsstufe aufgetreten ist, und den Akku erneut abfragen und feststellen, dass beide Ebenen erreicht wurden. Dies kann darauf hindeuten, dass Sie nicht häufig genug abfragen. Es kann auch darauf hindeuten, dass der Akku eine Ladung nicht sehr lange halten kann und schneller entladen wird, als Sie erwartet haben. Eine solche Batterie kann sich dem Ende ihrer Lebensdauer nähern oder beschädigt sein.

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

IOCTL_BATTERY_QUERY_INFORMATION

Share via