BATTERY _ SET _ INFORMATION-Struktur
Enthält zu setzende Akkuinformationen. Diese Struktur wird mit dem IOCTL _ BATTERY _ SET _ INFORMATION-Steuerungscode verwendet.
Syntax
typedef struct _BATTERY_SET_INFORMATION {
ULONG BatteryTag;
BATTERY_SET_INFORMATION_LEVEL InformationLevel;
UCHAR Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;
Member
-
BatteryTag
-
Das aktuelle Akkutag für den Akku. Informationen zu einem Akku, der mit dem Tag übereinstimmen, können nur zurückgegeben werden. Wenn dieser Wert nicht mit dem aktuellen Tag des Akkus übereinstimmen, wird die IOCTL-Anforderung mit ERROR FILE NOT FOUND abgeschlossen, was dem Aufrufer angibt, dass der Akku, für den er ein Tag hat, nicht mehr 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 akku-Informationen, die festgelegt werden sollen. Der Typ der Daten im Buffer-Member hängt vom Wert dieses Members ab. Dieser Member kann einer der folgenden Werte sein.
Wert Bedeutung - BatteryCharge
- 1
Informiert das Akkugerät darüber, dass der Benutzer angefordert hat, dass der Akku zu diesem Zeitpunkt geladen werden soll. Beispielsweise kann die Anwendung mit einem intelligenten Akku/Akku/Akku/Selektor einen Akku nach dem anderen aufladen. Der Buffer-Member dieser -Struktur wird ignoriert. - BatteryCriticalBias
- 0
Legt die kritische Voreingenommenheitsanpassung des Akkus fest. Beachten Sie, dass nicht vorgesehen ist, dass dieser Wert normalerweise von Software geändert wird und nur als Wartungsfeature in den Schnittstellen vorhanden ist. Nicht alle Akkus können eine solche Einstellung verwalten, und die Akkuinformationen sollten gelesen werden, um zu bestätigen, dass der Akku die Einstellung akzeptiert hat. - BatteryDischarge
- 2
Informiert das Akkugerät darüber, dass der Benutzer angefordert hat, dass der Akku zu diesem Zeitpunkt entladen wird. Dies kann beispielsweise verwendet werden, um anzugeben, welche Akkukapazität der Benutzer derzeit an das System anhing. Der Buffer-Member dieser -Struktur wird ignoriert. -
Buffer
-
Die akku-Informationen, die festgelegt werden sollen. Die Daten hängen vom Wert von InformationLevel ab.
Hinweise
Die BATTERY _ SET _ INFORMATION-Struktur ist eine Struktur variabler Länge, und Sie müssen einen Puffer mit geeigneter Größe zuordnen, damit die Informationen in die Struktur aufgenommen werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|