Partager via

EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus

  • Article

Retourne des informations sur l’état actuel de la batterie main.

Syntaxe

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 );

Paramètres

Ce
[in] Pointeur vers le EFI_BATTERY_CHARGING_PROTOCOL instance.

StateOfCharge
[out] Retourne l’état de charge actuel (SOC) de la batterie main. SOC est représenté en pourcentage, 100 % indiquant la charge totale.

Capacité nominale
[out] Retourne la capacité nominale de la batterie main, en mAh.

ChargeCurrent
[out] Si la batterie est en cours de chargement, retourne un nombre positif indiquant le courant fourni à la batterie en mA. Si la batterie est en cours de décharge, retourne un nombre négatif indiquant le courant tiré de la batterie en mA. Si la batterie n’est ni chargée, ni déchargée, elle retourne 0. Si le matériel ne parvient pas à fournir ces informations, il retourne EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000).

Valeur renvoyée

Retourne l’un des codes status suivants.

Code d’état Description
EFI_SUCCESS La fonction a bien retourné la valeur attendue.
EFI_INVALID_PARAMETER Un paramètre était incorrect.
EFI_DEVICE_ERROR L’appareil physique a signalé une erreur.
EFI_NOT_READY L’appareil physique est occupé ou n’est pas prêt à traiter cette demande.

Notes

Cette fonction retourne la capacité nominale et l’état de charge (SOC) pour la batterie main. Cette fonction est appelée régulièrement pour faciliter le traitement supplémentaire par le pilote qui implémente ce protocole.

Spécifications

En-tête: Utilisateur généré

EFI_BATTERY_CHARGING_PROTOCOL