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