EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus
Devuelve información sobre el estado actual de la batería principal.
Sintaxis
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
É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, 100% que indica el cargo completo.
RatedCapacity
[out] Devuelve la capacidad nominal de la batería principal, en mAh.
ChargeCurrent
[out] Si la batería está en proceso de carga, devuelve un número positivo que indica la corriente entregada a la batería en mA. Si la batería está en proceso de descarga, devuelve un número negativo que indica la corriente que se extrae de la batería en mA. Si la batería no se carga, ni se descarga, devuelve 0. Si el hardware no puede proporcionar esta información, devuelve EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000).
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
Esta función devuelve la capacidad nominal y el estado de carga (SOC) de la batería principal. Esta función se llama periódicamente para ayudar al procesamiento adicional por parte del controlador que implementa este protocolo.
Requisitos
Rúbrica: Usuario generado