Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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