EFI_BATTERY_CHARGING_PROTOCOL. ChargeBattery
Carica la batteria principale al livello di destinazione specificato con una carica massima corrente.
Sintassi
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 );
Parametri
This
[in] Puntatore all'istanza di EFI_BATTERY_CHARGING_PROTOCOL.
MaximumCurrent
[in] Facoltativo. Corrente massima in mA che può essere usata per caricare la batteria principale. Un valore NULL richiede al driver di implementare questo protocollo per gestire tali dettagli in modo autonomo.
TargetStateOfCharge
[in] Stato di carica di destinazione (SOC) della batteria principale dopo la quale la funzione restituirebbe se CompletionToken è NULL. SOC è rappresentato in percentuale, 100% che indica l'addebito completo.
CompletamentoToken
[in] Puntatore a un EFI_BATTERY_CHARGING_COMPLETION_TOKEN associato all'operazione di addebito richiesta.
Valore restituito
Restituisce uno dei codici di stato seguenti.
| Codice stato | Descrizione |
|---|---|
| EFI_SUCCESS | La funzione è stata restituita correttamente. |
| EFI_INVALID_PARAMETER | Parametro non corretto. |
| EFI_DEVICE_ERROR | Il dispositivo fisico ha segnalato un errore. |
| EFI_NOT_READY | Il dispositivo fisico è occupato o non è pronto per elaborare questa richiesta. |
Commenti
Questa funzione non blocca carica la batteria principale al livello di destinazione specificato con una carica massima corrente.
Per rilevare gli errori, il tipo di evento contenuto in CompletionToken deve essere EVT_NOTIFY_SIGNAL, creato usando CreateEventEx e deve associare un oggetto NotifyFunction a CompletionToken come NotifyContext. Il codice di errore di stato sarà disponibile tramite il membro Status di CompletamentoToken.
Requisiti
Intestazione: Utente generato