Freigeben über

EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation

  • Artikel

Gibt Informationen über den aktuellen Zustand der Standard Batterie zurück, einschließlich des Ladezustands, der Strommenge, die an die Batterie geliefert oder aus der Batterie gezogen wird, die Spannung über die Klemmen der Batterie, die Batterietemperatur, die Spannung über das USB-Kabel und den Strom über das USB-Kabel.

Syntax

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

Parameter

Dieser
[in] Ein Zeiger auf den EFI_BATTERY_CHARGING_PROTOCOL instance.

StateOfCharge
[out] Gibt den aktuellen Ladezustand (SOC) des Standard Akkus zurück. SOC wird in Prozent dargestellt, wobei 100 % eine vollständige Gebühr angibt.

CurrentIntoBattery
[out] Gibt einen der in der folgenden Tabelle aufgeführten Werte zurück.

Wert BESCHREIBUNG
Positive Zahl Der Akku wird gerade aufgeladen. Der Wert gibt den Strom an, der in mA an den Akku geliefert wird.
Negative Zahl Der Akku wird gerade entladen. Der Wert gibt den Strom an, der aus der Batterie in mA gezogen wird.
0 Der Akku wird nicht aufgeladen oder entladen.
EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) Die Hardware kann diese Informationen nicht bereitstellen.

BatteryTerminalVoltage
[out] Die Spannung über die Batterieklemmen in mV.

BatteryTemperature
[out] Die Temperatur der Batterie in 10ths of a Grad Kelvin.

USBCableVoltage
[out] Die Spannung über das USB-Kabel in mV.

USBCableCurrent
[out] Der Strom über das USB-Kabel in mA.

Rückgabewert

Gibt einen der folgenden status-Codes zurück.

Statuscode BESCHREIBUNG
EFI_SUCCESS Die Funktion wurde erfolgreich zurückgegeben.
EFI_INVALID_PARAMETER Ein Parameter war falsch.
EFI_DEVICE_ERROR Das physische Gerät hat einen Fehler gemeldet.
EFI_NOT_READY Das physische Gerät ist ausgelastet oder nicht bereit, diese Anforderung zu verarbeiten.

Bemerkungen

Diese Funktion wird in regelmäßigen Abständen von der UEFI-Batterieladeanwendung aufgerufen, um Informationen über den Akku abzurufen. Die Anwendung verwendet diese Informationen, um den Zustand der Batterie zu überwachen und Fehler zu diagnostizieren.

Hinweis

Diese Funktion ist ab der Revision 0x00010002 der EFI_BATTERY_CHARGING_PROTOCOL verfügbar. Wenn die UEFI-Batterieladeanwendung erkennt, dass nur revision 0x00010001 des Protokolls verfügbar ist, ruft sie EFI_BATTERY_CHARGING_PROTOCOL auf. Stattdessen GetBatteryStatus .

Anforderungen

Header: Benutzer generiert

EFI_BATTERY_CHARGING_PROTOCOL