共用方式為

EFI_BATTERY_CHARGING_PROTOCOL。ChargeBattery

  • 發行項

將主要電池充電至指定的目標層級，並具有目前最大費用。

語法

typedef EFI_STATUS (EFIAPI * EFI_BATTERY_CHARGING_CHARGE_BATTERY) (
    IN EFI_BATTERY_CHARGING_PROTOCOL *This,
    IN UINT32 MaximumCurrent, 
    IN UINT32 TargetStateOfCharge,
    IN EFI_BATTERY_CHARGING_COMPLETION_TOKEN *CompletionToken );

參數

這
[in]EFI_BATTERY_CHARGING_PROTOCOL 實例的指標。

MaximumCurrent
[in] 選用。 mA 中可用來充電主要電池的最大目前數。 Null 值會提示實作此通訊協定的驅動程式自行處理這類詳細資料。

TargetStateOfCharge
[in]主要電池 (SOC) 目標狀態，當 CompletionToken 為 Null 時，函式會傳回該狀態。 SOC 以百分比表示，100% 表示完整費用。

CompletionToken
[in]與要求費用作業相關聯的 EFI_BATTERY_CHARGING_COMPLETION_TOKEN 指標。

傳回值

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

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

備註

此非封鎖函式會將主要電池收費至指定的目標層級，並具有最大充電目前。

若要偵測錯誤， CompletedToken 中包含的事件種類必須EVT_NOTIFY_SIGNAL，使用 CreateEventEx 建立，而且必須將 NotifyFunction 與 CompletionToken 建立關聯為 NotifyCoNtext。 狀態錯誤碼可透過CompletionToken的Status成員取得。

規格需求

頭： 使用者產生的

EFI_BATTERY_CHARGING_PROTOCOL

EFI_BATTERY_CHARGING_COMPLETION_TOKEN