EFI_BATTERY_CHARGING_PROTOCOL. GetBatteryInformation
Возвращает сведения о текущем состоянии main батареи, включая состояние заряда, количество тока, поставляемого или извлекаемого из батареи, напряжения через клеммы батареи, температуру батареи, напряжение по USB-кабелю и ток через USB-кабель.
Синтаксис
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 );
Параметры
Это
[in] Указатель на экземпляр EFI_BATTERY_CHARGING_PROTOCOL.
StateOfCharge
[out] Возвращает текущее состояние заряда (SOC) main батареи. SOC представлен в процентах, где 100 % означает полную оплату.
CurrentIntoBattery
[out] Возвращает одно из значений, перечисленных в следующей таблице.
| Значение | Описание |
|---|---|
| Положительное число | Аккумулятор находится в процессе зарядки. Значение указывает на текущий момент, поставляемый к батарее в мА. |
| Отрицательное число | Батарея находится в процессе разрядки. Значение указывает, что ток извлекается из батареи в мА. |
| 0 | Аккумулятор не заряжается и не разряжается. |
| EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) | Оборудование не может предоставить эти сведения. |
BatteryTerminalVoltage
[out] Напряжение через клеммы батареи в мВ.
BatteryTemperature
[out] Температура батареи в 10 градусов Кельвина.
USBCableVoltage
[out] Напряжение через USB-кабель в мВ.
USBCableCurrent
[out] Ток через USB-кабель в mA.
Возвращаемое значение
Возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
| EFI_SUCCESS | Функция успешно возвращена. |
| EFI_INVALID_PARAMETER | Параметр задан неверно. |
| EFI_DEVICE_ERROR | Физическое устройство сообщило об ошибке. |
| EFI_NOT_READY | Физическое устройство занято или не готово к обработке этого запроса. |
Комментарии
Эта функция периодически вызывается приложением для зарядки батареи UEFI для получения сведений об аккумуляторе. Приложение использует эти сведения для мониторинга состояния батареи и диагностики ошибок.
Примечание
Эта функция доступна начиная с 0x00010002 редакции EFI_BATTERY_CHARGING_PROTOCOL. Если приложение для зарядки батареи UEFI обнаружит, что доступна только версия 0x00010001 протокола, оно вызовет EFI_BATTERY_CHARGING_PROTOCOL. Вместо этого getBatteryStatus .
Требования
Заголовка: Создано пользователем