BCLASS_SET_INFORMATION_CALLBACK Rückruffunktion (batclass.h)

Artikel
08/22/2023

BatteryMiniSetInformation fordert an, dass eine Batterie in den Lade- oder Entladezustand wechselt, oder legt einen kritischen Biaswert für den Akku fest.

Syntax

BCLASS_SET_INFORMATION_CALLBACK BclassSetInformationCallback;

NTSTATUS BclassSetInformationCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] BATTERY_SET_INFORMATION_LEVEL Level,
  [in] PVOID Buffer
)
{...}

Parameter

[in] Context

Ein Zeiger auf den Kontextbereich, der vom Miniklassentreiber für das Akkugerät zugewiesen wird.

[in] BatteryTag

Ein Akkutagwert, der zuvor von BatteryMiniQueryTag zurückgegeben wurde.

[in] Level

Einer der folgenden Werte: BatteryCriticalBias, BatteryCharge oder BatteryDischarge.

[in] Buffer

Die kritische Biasanpassung in Milliwatt, wenn LevelBatteryCriticalBias ist. Wird nicht für andere Werte von Level verwendet.

Rückgabewert

BatteryMiniSetInformation gibt eine der folgenden Rückgaben zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Vorgang wurde erfolgreich ausgeführt.
STATUS_NO_SUCH_DEVICE	Es ist kein Akku vorhanden.
STATUS_NOT_SUPPORTED	Der angegebene Akku unterstützt den angeforderten Vorgang nicht.
STATUS_UNSUCCESSFUL	Fehler beim Vorgang.

Hinweise

Der Akkuklassentreiber ruft BatteryMiniSetInformation auf, um anzufordern, dass ein Akku auf- oder entladen wird. Diese Routine kann auch aufgerufen werden, um einen Wert für kritische Verzerrungen festzulegen.

Bei einem intelligenten Ladegerät/Selektor gibt der Klassentreiber BatteryCharge an, um einen zu ladenden Akku auszuwählen, was möglicherweise das Aufladen eines anderen Akkus beendet.

Der Klassentreiber gibt BatteryDischarge an, um anzugeben, welcher Akku das System mit Strom versorgt.

Die Critical Bias-Anpassung entspricht der Reservekapazität des Gastanks in einem Automobil. Es stellt die verbleibende Ladung dar, wenn die Akkukapazität als null gemeldet wird. Obwohl der Klassentreiber den Wert für kritische Verzerrungen bei normaler Verwendung nicht ändert, wird dieses Feld in der Schnittstelle als Wartungsfeature bereitgestellt. Nicht alle Batterien können eine kritische Einstellung beibehalten. Miniklassentreiber für solche Batterien sollten STATUS_NOT_SUPPORTED zurückgeben.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	batclass.h (einschließlich Batclass.h)
IRQL	PASSIVE_LEVEL

Freigeben über