BCLASS_QUERY_STATUS_CALLBACK funzione di callback (batclass.h)

BatteryMiniQueryStatus restituisce informazioni sullo stato relative al dispositivo della batteria specificato.

Sintassi

BCLASS_QUERY_STATUS_CALLBACK BclassQueryStatusCallback;

NTSTATUS BclassQueryStatusCallback(
  [in]  PVOID Context,
  [in]  ULONG BatteryTag,
  [out] PBATTERY_STATUS BatteryStatus
)
{...}

Parametri

[in] Context

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

[in] BatteryTag

Valore del tag della batteria restituito in precedenza da BatteryMiniQueryTag.

[out] BatteryStatus

Puntatore a una struttura BATTERY_STATUS in cui il driver miniclasse restituisce informazioni.

Valore restituito

BatteryMiniQueryStatus restituisce uno dei seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La batteria designata da BatteryTag è attualmente installata.
STATUS_NO_SUCH_DEVICE	La batteria designata da BatteryTag non è presente.

Commenti

Il driver della classe batteria chiama BatteryMiniQueryStatus per ottenere informazioni sullo stato della batteria. Le informazioni sullo stato includono lo stato di alimentazione, la capacità, la tensione e la quantità di corrente che scorre al momento della richiesta.

Se il driver miniclasse non fornisce routine BatteryMiniSetStatusNotify e BatteryMiniDisableStatusNotify completamente funzionanti, il driver della classe batteria chiama BatteryMiniQueryStatus a intervalli regolari ma poco frequenti per eseguire il polling dello stato della batteria. In caso contrario, il driver di classe chiama questa routine dopo che il driver miniclasse lo ha informato di una modifica dello stato della batteria.

Prima di segnalare una batteria molto bassa, scaricando la batteria (BATTERY_DISCHARGING e BATTERY_CRITICAL), il driver miniclasse deve garantire che il problema sia legittimo (anziché uno stato transitorio) e, in tal caso, dovrebbe tentare di risolvere il problema. Le possibili soluzioni possono includere il passaggio all'alimentazione AC o a un'altra batteria. Quando il driver miniclasse segnala che una batteria è critica e scarica, il sistema presuppone che il guasto della batteria sia imminente e si prepara ad arrestare.

Requisiti

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

Vedi anche

BatteryClassStatusNotify

BatteryMiniDisableStatusNotify

BatteryMiniSetStatusNotify