EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation
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