BATTERY _ QUERY _ INFORMATION-Struktur
Enthält Informationen zur Akkuabfrage. Diese Struktur wird mit dem IOCTL _ BATTERY _ QUERY INFORMATION-Steuerungscode _ verwendet, um den Typ der zurück zu gebenden Informationen anzugeben.
Syntax
typedef struct _BATTERY_QUERY_INFORMATION {
ULONG BatteryTag;
BATTERY_QUERY_INFORMATION_LEVEL InformationLevel;
LONG AtRate;
} BATTERY_QUERY_INFORMATION, *PBATTERY_QUERY_INFORMATION;
Member
-
BatteryTag
-
Das aktuelle Akkutag für den Akku. Es können nur Informationen für einen Akku zurückgegeben werden, der mit dem Tag übereinstimmen kann. Wenn dieser Wert nicht mit dem aktuellen Tag des Akkus übereinstimmen, wird die IOCTL-Anforderung mit ERROR _ FILE _ NOT FOUND _ abgeschlossen. Dies weist den Aufrufer darauf hin, dass der dem Tag zugeordnete Akku länger vorhanden ist. Der Aufrufer kann den IOCTL _ BATTERY QUERY _ _ TAG-Vorgang verwenden, um das Tag des neu installierten Akkus zu bestimmen, sofern vorhanden. (Weitere Informationen finden Sie unter Akkutags.)
Wenn eine Abfrageinformationsanforderung erfolgt, wird dieser Wert überprüft. Wenn die Anforderung noch in Bearbeitung ist, während sich dieser Wert ändert, wird die Anforderung mit dem Status ERROR _ FILE NOT FOUND _ (FEHLERDATEI NICHT _ GEFUNDEN) abgebrochen.
-
InformationLevel
-
Die Ebene der abgefragten Akkuinformationen. Die von IOCTL zurückgegebenen Daten hängen von diesem Wert ab. Dieser Member kann einer der folgenden Werte sein.
Wert Bedeutung - BatteryDeviceName
- 4
Mit NULL beendete Unicode-Zeichenfolge, die den Namen des Akkus enthält. - BatteryEstimatedTime
- 3
Ein ULONG-Wert, der die geschätzte Akkulaufzeit in Sekunden angibt. Wenn die im AtRate-Member der BATTERY _ QUERY _ INFORMATION-Struktur bereitgestellte Entleerungsrate null ist, basiert diese Berechnung auf der aktuellen Entleerungsrate. Wenn AtRate ungleich 0 (null) ist, ist die zurückgegebene Zeit die erwartete Laufzeit für die gegebene Rate. Wenn die geschätzte Zeit unbekannt ist (z. B. wird der Akku nicht entladen, und der angegebene AtRate-Wert war null), ist der Rückgabewert BATTERY _ UNKNOWN _ TIME. Beachten Sie, dass dieser Wert bei einigen Akkusystemen nicht sehr genau ist und je nach aktuellem Energieverbrauch stark variieren kann, was von der Datenträgeraktivität und anderen Faktoren beeinflusst werden kann. Es gibt keinen Benachrichtigungsmechanismus für Änderungen an diesem Wert. - BatteryGranularityInformation
- 1
Ein Array von BATTERY _ REPORTING _ SCALE-Strukturen, nie mehr als vier Einträge. - BatteryInformation
- 0
Eine BATTERY _ INFORMATION-Struktur. - BatteryManufactureDate
- 5
Eine BATTERY _ MANUFACTURE _ DATE-Struktur. - BatteryManufactureName
- 6
Mit NULL beendete Unicode-Zeichenfolge, die den Namen des Herstellers des Akkus angibt. - BatterySerialNumber
- 8
Mit NULL beendete Unicode-Zeichenfolge, die die Seriennummer des Akkus angibt. - BatteryTemperature
- 2
Ein ULONG-Wert, der die aktuelle Temperatur des Akkus in 10 Grad Kelvin angibt. - BatteryUniqueID
- 7
Mit NULL beendete Unicode-Zeichenfolge, die den Akku eindeutig identifiziert. Dieser Wert kann zum Nachverfolgen eines bestimmten Akkus verwendet werden. Bei intelligenten Akkus wäre diese ID die Verkettung des Herstellernamens, des Gerätenamens, des Herstellungsdatums und einer druckbaren Darstellung der Seriennummer.
Dieser Wert soll dem Benutzer nicht angezeigt werden. -
AtRate
-
Dieser Member wird nur verwendet, wenn InformationLevel batteryEstimatedTime ist.
Wenn dieses Mitglied ungleich 0 (null) ist, handelt es sich um eine Leerlaufzeit, die verwendet wird, um die Zeit zu berechnen, bis der Akku für batteryEstimatedTime eines einzelnen Akkus entladen wird. Sie muss in mW angegeben werden und muss ein negativer Wert sein, um eine Akkuladerate anzugeben.
Hinweise
Einige Informationen zu Akkus sind optional oder für einige Akkus bedeutungslos. Wenn der angeforderte Datentyp für den aktuellen Akku nicht verfügbar ist, wird ERROR _ INVALID _ FUNCTION zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|