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 );
매개 변수
This
[in] EFI_BATTERY_CHARGING_PROTOCOL instance 대한 포인터입니다.
StateOfCharge
[out] 기본 배터리의 현재 SOC(충전 상태)를 반환합니다. SOC는 전체 요금을 나타내는 백분율로 100%로 표시됩니다.
RatedCapacity
[out] mAh에서 기본 배터리의 정격 용량을 반환합니다.
ChargeCurrent
[out] 배터리가 충전되는 중이면 mA에서 배터리에 전달되는 전류를 나타내는 양수를 반환합니다. 배터리가 방전되는 중이면 mA의 배터리에서 전류가 그려지는 것을 나타내는 음수를 반환합니다. 배터리가 충전되지 않고 방전되지 않으면 0을 반환합니다. 하드웨어에서 이 정보를 제공할 수 없는 경우 EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED(0x80000000)을 반환합니다.
반환 값
다음 상태 코드 중 하나를 반환합니다.
| 상태 코드 | Description |
|---|---|
| EFI_SUCCESS | 함수가 성공적으로 반환되었습니다. |
| EFI_INVALID_PARAMETER | 매개 변수가 잘못되었습니다. |
| EFI_DEVICE_ERROR | 물리적 디바이스에서 오류를 보고했습니다. |
| EFI_NOT_READY | 물리적 디바이스가 사용 중이거나 이 요청을 처리할 준비가 되지 않았습니다. |
설명
이 함수는 기본 배터리에 대한 SOC(정격 용량 및 충전 상태)를 반환합니다. 이 함수는 이 프로토콜을 구현하는 드라이버의 추가 처리를 지원하기 위해 주기적으로 호출됩니다.
요구 사항
헤더: 생성된 사용자