BATTERY_SET_INFORMATION-Struktur

Artikel
06/13/2023

Enthält festzulegende Akkuinformationen. Diese Struktur wird mit dem IOCTL_BATTERY_SET_INFORMATION-Steuerelementcode 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 für einen Akku, der dem Tag entspricht, können nur zurückgegeben werden. Wenn dieser Wert nicht mit dem aktuellen Tag des Akkus übereinstimmt, wird die IOCTL-Anforderung mit ERROR_FILE_NOT_FOUND abgeschlossen, die dem Aufrufer anzeigt, dass der Akku, für den ein Tag vorhanden ist, 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 durchgeführt wird, wird dieser Wert überprüft. Wenn die Anforderung ausgeführt wird, während sich dieser Wert ändert, wird die Anforderung außerdem mit dem status ERROR_FILE_NOT_FOUND abgebrochen.

InformationLevel

Die festzulegenden Akkuinformationen. Der Typ der Daten im Puffermember 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. Mit einem intelligenten Akku/Ladegerät/Selektor könnte die Anwendung beispielsweise jeweils einen Akku aufladen. Der Buffer-Member dieser Struktur wird ignoriert.
BatteryCriticalBias 0	Legt die Einstellung der kritischen Verzerrung des Akkus fest. Beachten Sie, dass dieser Wert normalerweise durch Software geändert wird und nur als Wartungsfeature in den Schnittstellen vorhanden ist. Nicht alle Akkus können eine solche Einstellung beibehalten, 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 die Entladung des Akkus zu diesem Zeitpunkt angefordert hat. Dies kann beispielsweise verwendet werden, um anzugeben, welche Batterie der Benutzer derzeit für das System verwenden möchte. Der Buffer-Member dieser Struktur wird ignoriert.

Buffer

Die festzulegenden Akkuinformationen. Die Daten hängen vom Wert von InformationLevel ab.

Bemerkungen

Die BATTERY_SET_INFORMATION-Struktur ist eine Struktur mit variabler Länge, und Sie müssen einen Puffer mit geeigneter Größe zuweisen, damit die Informationen in die Struktur einbezogen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Poclass.h; Batclass.h unter Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP

Siehe auch

IOCTL_BATTERY_SET_INFORMATION

Share via