EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation

  • Artigo

Retorna informações sobre o estado atual do main bateria, incluindo o estado de carga, a quantidade de corrente sendo entregue ou extraída da bateria, a tensão nos terminais da bateria, a temperatura da bateria, a tensão sobre o cabo USB e a corrente através do cabo USB.

Sintaxe

typedef EFI_STATUS (EFIAPI * EFI_BATTERY_CHARGING_GET_BATTERY_INFORMATION) (
    IN EFI_BATTERY_CHARGING_PROTOCOL *This,
    OUT UINT32 *StateOfCharge,
    OUT INT32 *CurrentIntoBattery,
    OUT UINT32 *BatteryTerminalVoltage, 
    OUT INT32 *BatteryTemperature,
    OUT UINT32 *USBCableVoltage,
    OUT UINT32 *USBCableCurrent );

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, em que 100% indica uma cobrança completa.

CurrentIntoBattery
[out] Retorna um dos valores listados na tabela a seguir.

Valor Descrição
Número positivo A bateria está sendo carregada. O valor indica o atual entregue à bateria em mA.
Número negativo A bateria está em processo de descarga. O valor indica a corrente que está sendo extraída da bateria em mA.
0 A bateria não está sendo carregada ou descarregada.
EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) O hardware não pode fornecer essas informações.

BatteryTerminalVoltage
[out] A tensão entre os terminais de bateria em mV.

BatteryTemperature
[out] A temperatura da bateria em 10º grau Kelvin.

USBCableVoltage
[out] A tensão sobre o cabo USB em mV.

USBCableCurrent
[out] A atual por meio do cabo USB em mA.

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 é chamada periodicamente pelo aplicativo de carregamento de bateria UEFI para recuperar informações sobre a bateria. O aplicativo usa essas informações para ajudar a monitorar o estado da bateria e diagnosticar erros.

Observação

Essa função está disponível a partir da revisão 0x00010002 do EFI_BATTERY_CHARGING_PROTOCOL. Se o aplicativo de carregamento de bateria UEFI detectar que apenas a revisão 0x00010001 do protocolo está disponível, ele chamará EFI_BATTERY_CHARGING_PROTOCOL. Em vez disso, GetBatteryStatus .

Requisitos

Cabeçalho: Usuário gerado

EFI_BATTERY_CHARGING_PROTOCOL