função de retorno de chamada BCLASS_SET_STATUS_NOTIFY_CALLBACK (batclass.h)
BatteryMiniSetStatusNotify define a capacidade da bateria e os níveis de estado de energia nos quais o driver de classe requer notificação.
Sintaxe
BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;
NTSTATUS BclassSetStatusNotifyCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[in] PBATTERY_NOTIFY BatteryNotify
)
{...}
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.
[in] BatteryNotify
Um ponteiro para uma estrutura de BATTERY_NOTIFY .
Retornar valor
BatteryMiniSetStatusNotify retorna um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
Uma bateria está instalada no momento. |
|
Nenhuma bateria está presente ou a marca de bateria fornecida é inválida. |
|
O driver de miniclasse não pode distinguir a condição de destino. |
Comentários
O driver da classe de bateria chama a rotina BatteryMiniSetStatusNotify de um driver de miniclasse para definir critérios para um intervalo aceitável de condições de bateria. Quando a capacidade da bateria ou o estado de energia se desvia desses critérios, o driver de miniclasse deve chamar BatteryClassStatusNotify para notificar o driver de classe.
No membro do PowerState da estrutura BATTERY_NOTIFY , o driver de classe especifica um ou mais estados de energia da bateria. Sempre que a bateria entra em um estado de energia que não está no PowerState, o driver de miniclasse deve notificar o driver de classe.
Nos membros LowCapacity e HighCapacity do BATTERY_NOTIFY, o driver de classe especifica um intervalo de capacidade. Quando a capacidade estiver acima ou abaixo desse intervalo, o driver de miniclasse deverá notificar o driver de classe.
Algumas baterias podem ser incapazes de distinguir as capacidades precisas solicitadas pelo driver de classe de bateria. Quando possível, os drivers de miniclasse para essas baterias devem tentar corrigir o erro para que o usuário possa ser informado quando a bateria se aproximar de um estado crítico. Caso contrário, esses drivers devem retornar STATUS_NOT_SUPPORTED.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | batclass.h (inclua Batclass.h) |
| IRQL | PASSIVE_LEVEL |