EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation
Devuelve información sobre el estado actual de la batería principal, incluido el estado de carga, la cantidad de corriente que se entrega o se extrae de la batería, el voltaje a través de los terminales de la batería, la temperatura de la batería, el voltaje sobre el cable USB y la corriente a través del cable USB.
Sintaxis
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
Éste
[in] Puntero a la instancia de EFI_BATTERY_CHARGING_PROTOCOL.
StateOfCharge
[out] Devuelve el estado actual de carga (SOC) de la batería principal. SOC se representa en porcentaje, donde el 100 % indica un cargo completo.
CurrentIntoBattery
[out] Devuelve uno de los valores enumerados en la tabla siguiente.
| Valor | Descripción |
|---|---|
| Número positivo | La batería está en proceso de carga. El valor indica la corriente entregada a la batería en mA. |
| Número negativo | La batería está en proceso de descarga. El valor indica la corriente que se extrae de la batería en mA. |
| 0 | La batería no se carga ni descarga. |
| EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) | El hardware no puede proporcionar esta información. |
BatteryTerminalVoltage
[out] Tensión a través de los terminales de batería en mV.
BatteryTemperature
[out] Temperatura de la batería en 10ths de un grado Kelvin.
USBCableVoltage
[out] Voltaje sobre el cable USB en mV.
USBCableCurrent
[out] Corriente a través del cable USB en mA.
Valor devuelto
Devuelve uno de los siguientes códigos de estado.
| status code | Descripción |
|---|---|
| EFI_SUCCESS | La función devolvió correctamente. |
| EFI_INVALID_PARAMETER | Un parámetro era incorrecto. |
| EFI_DEVICE_ERROR | El dispositivo físico notificó un error. |
| EFI_NOT_READY | El dispositivo físico está ocupado o no está listo para procesar esta solicitud. |
Observaciones
La aplicación de carga de batería UEFI llama periódicamente a esta función para recuperar información sobre la batería. La aplicación usa esta información para ayudar a supervisar el estado de la batería y diagnosticar errores.
Nota:
Esta función está disponible a partir de la revisión 0x00010002 del EFI_BATTERY_CHARGING_PROTOCOL. Si la aplicación de carga de batería UEFI detecta que solo está disponible la revisión 0x00010001 del protocolo, llamará a EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus en su lugar.
Requisitos
Rúbrica: Usuario generado