BCLASS_SET_STATUS_NOTIFY_CALLBACK Rückruffunktion (batclass.h)
BatteryMiniSetStatusNotify legt die Akkukapazität und die Energiezustandsstufen fest, bei denen der Klassentreiber eine Benachrichtigung erfordert.
Syntax
BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;
NTSTATUS BclassSetStatusNotifyCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[in] PBATTERY_NOTIFY BatteryNotify
)
{...}
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] BatteryNotify
Ein Zeiger auf eine BATTERY_NOTIFY-Struktur .
Rückgabewert
BatteryMiniSetStatusNotify gibt eine der folgenden Rückgaben zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Derzeit ist ein Akku installiert. |
|
Es ist kein Akku vorhanden, oder das angegebene Akkutag ist ungültig. |
|
Der Miniklassentreiber kann die Zielbedingung nicht unterscheiden. |
Hinweise
Der Akkuklassentreiber ruft die BatteryMiniSetStatusNotify-Routine eines Miniklassentreibers auf, um Kriterien für einen akzeptablen Bereich der Akkubedingungen festzulegen. Wenn die Kapazität oder der Stromzustand der Batterie von diesen Kriterien abweicht, muss der Miniklassentreiber BatteryClassStatusNotify aufrufen, um den Klassentreiber zu benachrichtigen.
Im PowerState-Element der BATTERY_NOTIFY-Struktur gibt der Klassentreiber einen oder mehrere Akkuleistungszustände an. Jedes Mal, wenn der Akku in einen Stromzustand wechselt, der sich nicht in PowerState befindet, muss der Miniklassentreiber den Klassentreiber benachrichtigen.
In den Membern LowCapacity und HighCapacity von BATTERY_NOTIFY gibt der Klassentreiber einen Kapazitätsbereich an. Wenn die Kapazität diesen Bereich über- oder unterschreitet, muss der Miniklassentreiber den Klassentreiber benachrichtigen.
Einige Batterien können möglicherweise nicht die vom Batterieklassentreiber angeforderten genauen Kapazitäten unterscheiden. Wenn möglich, sollten Miniklassentreiber für diese Batterien versuchen, den Fehler zu korrigieren, damit der Benutzer informiert werden kann, wenn sich der Akku einem kritischen Zustand nähert. Andernfalls sollten solche Treiber STATUS_NOT_SUPPORTED zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | batclass.h (einschließlich Batclass.h) |
| IRQL | PASSIVE_LEVEL |