EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation
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