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

매개 변수

This
[in] EFI_BATTERY_CHARGING_PROTOCOL instance 대한 포인터입니다.

StateOfCharge
[out] 기본 배터리의 현재 SOC(충전 상태)를 반환합니다. SOC는 백분율로 표시됩니다. 여기서 100%는 전체 요금을 나타냅니다.

CurrentIntoBattery
[out] 다음 표에 나열된 값 중 하나를 반환합니다.

값	Description
양수	배터리가 충전되는 중입니다. 값은 mA의 배터리에 전달되는 전류를 나타냅니다.
음수	배터리가 방전되는 중입니다. 값은 mA의 배터리에서 그려지는 전류를 나타냅니다.
0	배터리가 충전되거나 방전되지 않습니다.
EFI_BATTERY_CHARGE_CURRENT_NOT_SUPPORTED(0x80000000)	하드웨어에서 이 정보를 제공할 수 없습니다.

BatteryTerminalVoltage
[out] 배터리 터미널의 전압(mV)입니다.

BatteryTemperature
[out] 10도 켈빈의 배터리 온도.

USBCableVoltage
[out] USB 케이블의 전압(mV)입니다.

USBCableCurrent
[out] mA의 USB 케이블을 통한 전류입니다.

반환 값

다음 상태 코드 중 하나를 반환합니다.

상태 코드	Description
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