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
Poclass.h;
Batclass.h auf Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003
und Windows XP

Weitere Informationen

_IOCTL-AKKUSATZINFORMATIONEN _ _