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 。

規格需求

頭： 使用者產生的

EFI_BATTERY_CHARGING_PROTOCOL