Partager via


EFI_BATTERY_CHARGING_PROTOCOL. ChargeBattery

Charge la batterie main au niveau cible spécifié avec un courant de charge maximal.

Syntaxe

typedef EFI_STATUS (EFIAPI * EFI_BATTERY_CHARGING_CHARGE_BATTERY) (
    IN EFI_BATTERY_CHARGING_PROTOCOL *This,
    IN UINT32 MaximumCurrent, 
    IN UINT32 TargetStateOfCharge,
    IN EFI_BATTERY_CHARGING_COMPLETION_TOKEN *CompletionToken );

Paramètres

Ce
[in] Pointeur vers le EFI_BATTERY_CHARGING_PROTOCOL instance.

MaximumCurrent
[in] Facultatif. Courant maximal en mA qui peut être utilisé pour charger la batterie main. Une valeur NULL invite le pilote implémentant ce protocole à gérer ces détails par lui-même.

TargetStateOfCharge
[in] État de charge cible (SOC) de la batterie main après laquelle la fonction retourne si CompletionToken a la valeur NULL. SOC est représenté en pourcentage, 100 % indiquant la charge complète.

CompletionToken
[in] Pointeur vers un EFI_BATTERY_CHARGING_COMPLETION_TOKEN associé à l’opération de frais demandée.

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 non bloquante charge la batterie main au niveau cible spécifié avec un courant de charge maximal.

Pour détecter les erreurs, le type d’événement contenu dans CompletionToken doit être EVT_NOTIFY_SIGNAL, créé à l’aide de CreateEventEx et doit associer un NotifyFunction à CompletionToken en tant que NotifyContext. Le code d’erreur status sera disponible via le membre Status de CompletionToken.

Spécifications

En-tête: Généré par l’utilisateur

EFI_BATTERY_CHARGING_PROTOCOL

EFI_BATTERY_CHARGING_COMPLETION_TOKEN