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.
BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;
NTSTATUS BclassSetStatusNotifyCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[in] PBATTERY_NOTIFY BatteryNotify
)
{...}
[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 .
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. |
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.
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | batclass.h (einschließlich Batclass.h) |
| IRQL | PASSIVE_LEVEL |