> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XINPUT_BATTERY_INFORMATION

> XINPUT_BATTERY_INFORMATION

# XINPUT\_BATTERY\_INFORMATION

배터리의 유형과 충전 상태를 설명합니다.

## 구문

```cpp theme={null}
typedef struct XINPUT_BATTERY_INFORMATION {  
    BYTE BatteryType;  
    BYTE BatteryLevel;  
} XINPUT_BATTERY_INFORMATION  
```

### 멤버

*BatteryType*\
형식: BYTE

다음 값 중 하나로 표시된 배터리의 유형입니다.

| 값 | 설명 |
| - | - |
| BATTERY\_TYPE\_DISCONNECTED | 장치가 연결되지 않았습니다. |
| BATTERY\_TYPE\_WIRED | 장치가 유선이며 배터리가 없습니다. |
| BATTERY\_TYPE\_ALKALINE | 장치에 알칼리 배터리가 있습니다. |
| BATTERY\_TYPE\_NIMH | 장치에 니켈-금속 수소화물(NiMH) 배터리가 있습니다. |
| BATTERY\_TYPE\_UNKNOWN | 장치의 배터리 유형이 알려져 있지 않습니다. |

*BatteryLevel*\
형식: BYTE

완전 충전 용량과 비교한 배터리의 충전 상태이며, 다음 값 중 하나입니다.

| 값 | 설명 |
| - | - |
| BATTERY\_LEVEL\_EMPTY | 충전량이 0에서 10% 사이입니다. |
| BATTERY\_LEVEL\_LOW | 충전량이 10%에서 40% 사이입니다. |
| BATTERY\_LEVEL\_MEDIUM | 충전량이 40%에서 70% 사이입니다. |
| BATTERY\_LEVEL\_FULL | 충전량이 70%에서 100% 사이입니다. |

## 설명

*BatteryLevel* 값은 알려진 배터리 유형이 있는 장치에만 유효합니다.

이 구조체는 [XInputGetBatteryInformation](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md) 함수에서 사용됩니다.

자세한 내용은 [XInputOnGameInput 래퍼](https://docs.xbox.com/ko/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection)를 참조하세요.

## 요구 사항

**헤더:** XInputOnGameInput.h

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 참고 항목

[XInput에서 GameInput으로 이식](https://docs.xbox.com/ko/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/ko/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetBatteryInformation](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputOnGameInput (API 콘텐츠)](https://docs.xbox.com/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_CAPABILITIES](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XINPUT_KEYSTROKE](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_keystroke.md)