BCLASS_SET_STATUS_NOTIFY_CALLBACK funzione di callback (batclass.h)

BatteryMiniSetStatusNotify imposta i livelli di capacità e stato della batteria in base al quale il driver di classe richiede la notifica.

Sintassi

BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;

NTSTATUS BclassSetStatusNotifyCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] PBATTERY_NOTIFY BatteryNotify
)
{...}

Parametri

[in] Context

Puntatore all'area di contesto allocata dal driver miniclasse per il dispositivo batteria.

[in] BatteryTag

Valore del tag della batteria restituito in precedenza da BatteryMiniQueryTag.

[in] BatteryNotify

Puntatore a una struttura di BATTERY_NOTIFY .

Valore restituito

BatteryMiniSetStatusNotify restituisce uno dei seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Una batteria è attualmente installata.
STATUS_NO_SUCH_DEVICE	Nessuna batteria presente o il tag della batteria specificato non è valido.
STATUS_NOT_SUPPORTED	Il driver miniclasse non può distinguere la condizione di destinazione.

Commenti

Il driver della classe batteria chiama la routine BatteryMiniSetStatusNotify di un miniclasse per impostare i criteri per una gamma accettabile di condizioni di batteria. Quando la capacità o lo stato di alimentazione della batteria devia da questi criteri, il driver miniclasse deve chiamare BatteryClassStatusNotify per notificare al driver di classe.

Nel membro PowerState della struttura BATTERY_NOTIFY , il driver di classe specifica uno o più stati di alimentazione della batteria. Ogni volta che la batteria entra in uno stato di alimentazione che non è in PowerState, il driver miniclasse deve notificare al conducente della classe.

Nei membri LowCapacity e HighCapacity di BATTERY_NOTIFY, il driver di classe specifica un intervallo di capacità. Quando la capacità scende sopra o al di sotto di questo intervallo, il driver miniclasse deve notificare al driver di classe.

Alcune batterie potrebbero non essere in grado di distinguere le capacità precise richieste dal driver della classe di batteria. Quando possibile, i driver miniclasse per queste batterie devono tentare di correggere l'errore in modo che l'utente possa essere informato quando la batteria si avvicina a uno stato critico. In caso contrario, tali driver devono restituire STATUS_NOT_SUPPORTED.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	batclass.h (include Batclass.h)
IRQL	PASSIVE_LEVEL

Vedi anche

BatteryClassStatusNotify

BatteryMiniDisableStatusNotify