> ## 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.

# GameInputBatteryState (사용되지 않음)

> GameInputBatteryState

# GameInputBatteryState

> [!WARNING]
>
> **사용되지 않음.** 이 구조체는 GameInput v1에서 제거되었으며 현재 API에서 사용할 수 없습니다.

입력 장치의 현재 배터리 상태를 설명합니다.

## 구문

```cpp theme={null}
typedef struct GameInputBatteryState {
    GameInputBatteryStatus status;
    float chargeRate;
    float remainingCapacity;
    float fullChargeCapacity;
} GameInputBatteryState;
```

## 멤버

**status**\
형식: [GameInputBatteryStatus](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)

배터리의 현재 상태입니다(예: 충전 중, 방전 중, 완전 충전).

**chargeRate**\
형식: float

배터리의 현재 충전 속도(단위: Wh)입니다. 음수 값은 방전을 나타냅니다.

**remainingCapacity**\
형식: float

남은 배터리 용량(단위: Wh)입니다.

**fullChargeCapacity**\
형식: float

배터리의 완전 충전 용량(단위: Wh)입니다.

## 설명

이 구조체는 사용되지 않는 [IGameInputDevice::GetBatteryState](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md) 메서드와 함께 사용되었으며, 이 메서드는 v1에서 제거되었습니다. 현재 API에는 배터리 상태를 직접 쿼리하는 방법이 없습니다.

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v1** | 제거되었습니다. |
| **v0** | 도입되었습니다. |

## 함께 보기

[사용되지 않는 GameInput API 멤버](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[GameInputBatteryStatus](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
[IGameInputDevice::GetBatteryState](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)


## Related topics

- [GameInputBatteryStatus (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
- [IGameInputDevice::GetBatteryState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)
- [GameInputTouchState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [GameInputMotionState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputmotionstate.md)
- [GameInputUiNavigationState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputuinavigationstate.md)
