EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus
Restituisce informazioni sullo stato corrente della batteria principale.
Sintassi
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 );
Parametri
This
[in] Puntatore all'istanza di EFI_BATTERY_CHARGING_PROTOCOL.
StateOfCharge
[out] Restituisce lo stato corrente di carica (SOC) della batteria principale. SOC è rappresentato in percentuale, 100% che indica l'addebito completo.
RatedCapacity
[out] Restituisce la capacità valutata della batteria principale, in mAh.
ChargeCurrent
[out] Se la batteria è in fase di caricamento, restituisce un numero positivo che indica l'attuale recapitata alla batteria in mA. Se la batteria è in fase di scaricamento, restituisce un numero negativo che indica l'attuale tratto dalla batteria in mA. Se la batteria non viene caricata né scaricata, restituisce 0. Se l'hardware non è in grado di fornire queste informazioni, restituisce EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000).
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 restituisce capacità valutata e stato di carica (SOC) per la batteria principale. Questa funzione viene chiamata periodicamente per facilitare l'elaborazione aggiuntiva dal driver che implementa questo protocollo.
Requisiti
Intestazione: Utente generato