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

# GameInputBatteryState

> GameInputBatteryState

# GameInputBatteryState

<Warning>**Deprecated.** This structure was removed in GameInput v1 and is not available in the current API.</Warning>

Describes the current battery state of an input device.

## Syntax

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

## Members

**status**\
Type: [GameInputBatteryStatus](/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)

The current status of the battery (e.g., charging, discharging, full).

**chargeRate**\
Type: float

The current charge rate of the battery, in Wh. A negative value indicates discharging.

**remainingCapacity**\
Type: float

The remaining battery capacity, in Wh.

**fullChargeCapacity**\
Type: float

The full charge capacity of the battery, in Wh.

## Remarks

This structure was used with the deprecated [IGameInputDevice::GetBatteryState](/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate) method, which was removed in v1. No direct battery state query exists in the current API.

## Version History

| Version | Changes     |
| ------- | ----------- |
| **v1**  | Removed.    |
| **v0**  | Introduced. |

## See also

[Deprecated GameInput API members](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputBatteryStatus](/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)
[IGameInputDevice::GetBatteryState](/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate)


## Related topics

- [IGameInputDevice::GetBatteryState](/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)
- [GameInputBatteryStatus](/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [Deprecated GameInput API members](/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputGamepadState](/reference/input/gameinput/structs/gameinputgamepadstate.md)