EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryStatus
Gibt Informationen zum aktuellen Zustand des Standard Akkus zurück.
Syntax
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 );
Parameter
Dieser
[in] Ein Zeiger auf die EFI_BATTERY_CHARGING_PROTOCOL instance.
StateOfCharge
[out] Gibt den aktuellen Ladezustand (SOC) des Standard Akkus zurück. SOC wird in Prozent dargestellt, 100 % gibt die volle Gebühr an.
RatedCapacity
[out] Gibt die Nennkapazität des Standard Akkus in mAh zurück.
ChargeCurrent
[out] Wenn der Akku gerade geladen wird, gibt eine positive Zahl zurück, die den Strom angibt, der in mA an den Akku geliefert wird. Wenn die Batterie gerade entladen wird, gibt eine negative Zahl zurück, die den Strom angibt, der in mA aus der Batterie gezogen wird. Wenn der Akku weder aufgeladen noch entladen wird, gibt er 0 zurück. Wenn die Hardware diese Informationen nicht bereitstellen kann, gibt sie EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) zurück.
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 gibt die Nennkapazität und den Ladezustand (SOC) für den Standard Akkus zurück. Diese Funktion wird in regelmäßigen Abständen aufgerufen, um die zusätzliche Verarbeitung durch den Treiber zu unterstützen, der dieses Protokoll implementiert.
Anforderungen
Header: Vom Benutzer generiert