Partager via

EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation

  • Article

Retourne des informations sur l’état actuel de la batterie main, y compris l’état de charge, la quantité de courant fournie ou extraite de la batterie, la tension sur les bornes de la batterie, la température de la batterie, la tension sur le câble USB et le courant via le câble USB.

Syntaxe

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

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, où 100 % indique une charge complète.

CurrentIntoBattery
[out] Retourne l’une des valeurs répertoriées dans le tableau suivant.

Valeur Description
Nombre positif La batterie est en cours de chargement. La valeur indique le courant remis à la batterie en mA.
Nombre négatif La batterie est en train d’être déchargée. La valeur indique le courant tiré de la batterie en mA.
0 La batterie n’est pas chargée ou déchargée.
EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) Le matériel ne peut pas fournir ces informations.

BatteryTerminalVoltage
[out] Tension sur les bornes de la batterie en mV.

BatteryTemperature
[out] La température de la batterie en 10èmes d’un degré Kelvin.

USBCableVoltage
[out] Tension sur le câble USB en mV.

USBCableCurrent
[out] Courant via le câble USB dans mA.

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 est appelée régulièrement par l’application de charge de batterie UEFI pour récupérer des informations sur la batterie. L’application utilise ces informations pour surveiller l’état de la batterie et diagnostiquer les erreurs.

Notes

Cette fonction est disponible à partir du 0x00010002 de révision du EFI_BATTERY_CHARGING_PROTOCOL. Si l’application de charge de batterie UEFI détecte que seule la révision 0x00010001 du protocole est disponible, elle appelle EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus à la place.

Spécifications

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

EFI_BATTERY_CHARGING_PROTOCOL