BATTERY_INFORMATION Struktur
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 |
|