Compartilhar via

função de retorno de chamada BCLASS_SET_INFORMATION_CALLBACK (batclass.h)

  • Artigo

BatteryMiniSetInformation solicita que uma bateria insira o estado de carregamento ou descarregamento ou defina um valor de viés crítico para a bateria.

Sintaxe

BCLASS_SET_INFORMATION_CALLBACK BclassSetInformationCallback;

NTSTATUS BclassSetInformationCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] BATTERY_SET_INFORMATION_LEVEL Level,
  [in] PVOID Buffer
)
{...}

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] Level

Um dos seguintes valores: BatteryCriticalBias, BatteryCharge ou BatteryDischarge.

[in] Buffer

O ajuste de viés crítico em miliwatts se Level for BatteryCriticalBias. Não usado para outros valores de Level.

Retornar valor

BatteryMiniSetInformation retorna um dos seguintes:

Código de retorno Descrição
STATUS_SUCCESS
 A operação foi realizada com êxito.
STATUS_NO_SUCH_DEVICE
 Nenhuma bateria está presente.
STATUS_NOT_SUPPORTED
 A bateria especificada não dá suporte à operação solicitada.
STATUS_UNSUCCESSFUL
 Falha na operação.

Comentários

O driver da classe de bateria chama BatteryMiniSetInformation para solicitar que uma bateria comece a carregar ou descarregar. Ele também pode chamar essa rotina para definir um valor de viés crítico.

Com um carregador/seletor de bateria inteligente, o driver de classe especifica BatteryCharge para selecionar uma bateria a ser carregada, possivelmente descontinuando o carregamento de outra bateria.

O driver de classe especifica BatteryDischarge para indicar qual bateria deve ligar o sistema.

O ajuste de viés crítico é análogo à capacidade de reserva do tanque de gás em um automóvel. Ele representa a carga restante quando a capacidade da bateria é relatada como zero. Embora o driver de classe não altere o valor de viés crítico no uso normal, esse campo é fornecido na interface como um recurso de manutenção. Nem todas as baterias podem manter uma configuração de viés crítico. Os drivers de miniclasse para essas baterias devem retornar STATUS_NOT_SUPPORTED.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho batclass.h (inclua Batclass.h)
IRQL PASSIVE_LEVEL