Compartir a través de

EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus

  • Artículo

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

EFI_BATTERY_CHARGING_PROTOCOL