EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus

  • Artigo

Retorna informações sobre o estado atual da bateria main.

Sintaxe

typedef EFI_STATUS (EFIAPI * EFI_BATTERY_CHARGING_GET_BATTERY_STATUS) (
    IN EFI_BATTERY_CHARGING_PROTOCOL *This,
    OUT UINT32 *StateOfCharge,
    OUT UINT32 *RatedCapacity,
    OUT INT32 *ChargeCurrent );

Parâmetros

Este
[in] Um ponteiro para a instância EFI_BATTERY_CHARGING_PROTOCOL.

StateOfCharge
[out] Retorna o soc (estado de carga) atual da bateria main. SOC é representado em porcentagem, 100% indicando cobrança total.

RatedCapacity
[out] Retorna a capacidade classificada do main bateria, em mAh.

ChargeCurrent
[out] Se a bateria estiver sendo carregada, retornará um número positivo indicando a corrente entregue à bateria em mA. Se a bateria estiver em processo de descarga, retornará um número negativo indicando a corrente que está sendo extraída da bateria em mA. Se a bateria não estiver sendo carregada nem descarregada, ela retornará 0. Se o hardware não puder fornecer essas informações, ele retornará EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000).

Valor Retornado

Retorna um dos seguintes códigos de status.

Código de status Descrição
EFI_SUCCESS A função foi retornada com êxito.
EFI_INVALID_PARAMETER Um parâmetro estava incorreto.
EFI_DEVICE_ERROR O dispositivo físico relatou um erro.
EFI_NOT_READY O dispositivo físico está ocupado ou não está pronto para processar essa solicitação.

Comentários

Essa função retorna a capacidade classificada e o estado de carga (SOC) para a bateria main. Essa função é chamada periodicamente para auxiliar o processamento adicional pelo driver que implementa esse protocolo.

Requisitos

Cabeçalho: Usuário gerado

EFI_BATTERY_CHARGING_PROTOCOL