EFI_BATTERY_CHARGING_PROTOCOL。GetBatteryStatus

  • 發行項

傳回主要電池目前狀態的相關資訊。

語法

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 );

參數

這
[in]EFI_BATTERY_CHARGING_PROTOCOL 實例的指標。

StateOfCharge
[out]傳回主要電池的目前充電狀態 (SOC) 。 SOC 以百分比表示，100% 表示完整費用。

RatedCapacity
[out]以 mAh 傳回主要電池的評等容量。

ChargeCurrent
[out]如果電池正在收費中，則傳回正數，指出目前在 mA 中傳遞至電池的正數。 如果電池正在被釋放，則傳回負數，指出目前從 mA 中的電池繪製。 如果電池未收費，也不會被釋放，則會傳回 0。 如果硬體無法提供這項資訊，則會傳回EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED (0x80000000) 。

傳回值

傳回下列其中一個狀態碼。

狀態碼 描述
EFI_SUCCESS 函式成功傳回。
EFI_INVALID_PARAMETER 參數錯誤。
EFI_DEVICE_ERROR 實體裝置回報錯誤。
EFI_NOT_READY 實體裝置忙碌中或尚未準備好處理此要求。

備註

此函式會針對主要電池傳回 (SOC) 的充電容量和狀態。 此函式會定期呼叫，以協助驅動程式實作此通訊協定的其他處理。

規格需求

頭： 使用者產生的

EFI_BATTERY_CHARGING_PROTOCOL