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

# XINPUT_BATTERY_INFORMATION

> XINPUT_BATTERY_INFORMATION

# XINPUT\_BATTERY\_INFORMATION

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

<a id="syntaxSection" />

## 구문

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

<a id="membersSection" />

### 멤버

*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% 사이입니다. |

<a id="remarksSection" />

## 설명

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

이 구조체는 [XInputGetBatteryInformation](/reference/input/xinputongameinput/functions/xinputgetbatteryinformation) 함수에서 사용됩니다.

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

<a id="requirementsSection" />

## 요구 사항

**헤더:** XInputOnGameInput.h

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

<a id="seealsoSection" />

## 참고 항목

[XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XInputGetBatteryInformation](/ko/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_GAMEPAD](/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_CAPABILITIES](/ko/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XINPUT_KEYSTROKE](/ko/reference/input/xinputongameinput/structs/xinput_keystroke.md)