Condividi tramite

EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation

  • Articolo

Restituisce informazioni sullo stato corrente della batteria principale, tra cui lo stato di carica, la quantità di corrente consegnata o estratta dalla batteria, la tensione tra i terminali della batteria, la temperatura della batteria, la tensione sul cavo USB e la corrente tramite il cavo USB.

Sintassi

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

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, dove il 100% indica un addebito completo.

CurrentIntoBattery
[out] Restituisce uno dei valori elencati nella tabella seguente.

Valore Descrizione
Numero positivo La batteria è in corso di carica. Il valore indica l'attuale recapitata alla batteria in mA.
Numero negativo La batteria è in corso di scaricamento. Il valore indica l'oggetto corrente disegnato dalla batteria in mA.
0 La batteria non viene caricata o scaricata.
EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) L'hardware non è in grado di fornire queste informazioni.

BatteryTerminalVoltage
[out] Tensione tra i terminali della batteria in mV.

BatteryTemperature
[out] La temperatura della batteria in 10 di un grado Kelvin.

USBCableVoltage
[out] Tensione sul cavo USB in mV.

USBCableCurrent
[out] Corrente tramite il cavo USB in mA.

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 viene chiamata periodicamente dall'applicazione di ricarica della batteria UEFI per recuperare informazioni sulla batteria. L'applicazione usa queste informazioni per monitorare lo stato della batteria e diagnosticare gli errori.

Nota

Questa funzione è disponibile a partire dalla revisione 0x00010002 dell'EFI_BATTERY_CHARGING_PROTOCOL. Se l'applicazione di ricarica della batteria UEFI rileva che è disponibile solo la revisione 0x00010001 del protocollo, chiamerà EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus .

Requisiti

Intestazione: Utente generato

EFI_BATTERY_CHARGING_PROTOCOL