EFI_BATTERY_CHARGING_PROTOCOL。GetBatteryInformation
傳回主要電池目前狀態的相關資訊，包括充電狀態、要傳遞至電池的目前數量或從電池繪製量、電池終端機的電壓、電池溫度、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) 。 SOC 以百分比表示，其中 100% 表示完全收費。
CurrentIntoBattery
[out]傳回下表所列的其中一個值。
| 值 | 描述 |
|---|---|
| 正數 | 電池正在收費。 值表示目前傳遞至 mA 中的電池。 |
| 負數 | 電池正在釋放。 值表示目前從 mA 中的電池繪製。 |
| 0 | 電池未充電或電池計量不足。 |
| EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) | 硬體無法提供這項資訊。 |
BatteryTerminalVoltage
[out]以 mV 為單位的電池終端機電壓。
BatteryTemperature
[out]Kelvin 10 分之 10 的電池溫度。
USBCableVoltage
[out]mV 中 USB 纜線的電壓。
USBCableCurrent
[out]mA 中的目前透過 USB 纜線。
傳回值
傳回下列其中一個狀態碼。
| 狀態碼 | 描述 |
|---|---|
| EFI_SUCCESS | 函式成功傳回。 |
| EFI_INVALID_PARAMETER | 參數錯誤。 |
| EFI_DEVICE_ERROR | 實體裝置回報錯誤。 |
| EFI_NOT_READY | 實體裝置忙碌中或尚未準備好處理此要求。 |
備註
UEFI 電池充電應用程式會定期呼叫此函式，以擷取電池的相關資訊。 應用程式會使用這項資訊來協助監視電池的狀態，並診斷錯誤。
注意
此函式可從EFI_BATTERY_CHARGING_PROTOCOL的修訂0x00010002開始提供。 如果 UEFI 電池充電應用程式偵測到只有通訊協定的修訂0x00010001可用，則會呼叫 EFI_BATTERY_CHARGING_PROTOCOL。請改用 GetBatteryStatus 。
規格需求
頭： 使用者產生的