função de retorno de chamada BCLASS_QUERY_STATUS_CALLBACK (batclass.h)
BatteryMiniQueryStatus retorna status informações sobre o dispositivo de bateria fornecido.
Sintaxe
BCLASS_QUERY_STATUS_CALLBACK BclassQueryStatusCallback;
NTSTATUS BclassQueryStatusCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[out] PBATTERY_STATUS BatteryStatus
)
{...}
Parâmetros
[in] Context
Um ponteiro para a área de contexto alocada pelo driver de miniclasse para o dispositivo de bateria.
[in] BatteryTag
Um valor de marca de bateria retornado anteriormente por BatteryMiniQueryTag.
[out] BatteryStatus
Um ponteiro para uma estrutura BATTERY_STATUS na qual o driver de miniclasse retorna informações.
Valor retornado
BatteryMiniQueryStatus retorna um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
A bateria designada por BatteryTag está instalada no momento. |
|
A bateria designada por BatteryTag não está presente. |
Comentários
O driver da classe de bateria chama BatteryMiniQueryStatus para obter status informações sobre a bateria. As informações de status incluem o estado de energia da bateria, a capacidade, a tensão e a quantidade de corrente que flui no momento da solicitação.
Se o driver de miniclasse não fornecer rotinas BatteryMiniSetStatusNotify e BatteryMiniDisableStatusNotify totalmente funcionais, o driver da classe de bateria chamará BatteryMiniQueryStatus em intervalos regulares, mas pouco frequentes, para sondar o status da bateria. Caso contrário, o driver de classe chamará essa rotina depois que o driver de miniclasse o notificou de uma alteração na bateria status.
Antes de relatar uma bateria extremamente baixa e descarregada (BATTERY_DISCHARGING e BATTERY_CRITICAL), o driver de miniclasse deve garantir que o problema seja legítimo (em vez de um estado transitório) e, nesse caso, deve tentar resolver o problema. As possíveis soluções podem incluir a mudança para a energia ac ou para outra bateria. Quando o driver de miniclasse relata que uma bateria é crítica e descarregada, o sistema pressupõe que a falha da bateria é iminente e se prepara para desligar.
Requisitos
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | batclass.h (inclua Batclass.h) |
| IRQL | PASSIVE_LEVEL |