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

Describes the type and charge state of a battery.

## Syntax

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

### Members

*BatteryType*\
Type: BYTE

The type of the battery, as one of the following values:

| Value | Description |
| - | - |
| BATTERY\_TYPE\_DISCONNECTED | The device is not connected. |
| BATTERY\_TYPE\_WIRED | The device is wired and does not have a battery. |
| BATTERY\_TYPE\_ALKALINE | The device has an alkaline battery. |
| BATTERY\_TYPE\_NIMH | The device has a nickel-metal hydride (NiMH) battery. |
| BATTERY\_TYPE\_UNKNOWN | The device has an unknown battery type. |

*BatteryLevel*\
Type: BYTE

The charge state of the battery, compared to its full-charge capacity, as one of the following values:

| Value | Description |
| - | - |
| BATTERY\_LEVEL\_EMPTY | Charge is between zero and 10%. |
| BATTERY\_LEVEL\_LOW | Charge is between 10% and 40%. |
| BATTERY\_LEVEL\_MEDIUM | Charge is between 40% and 70%. |
| BATTERY\_LEVEL\_FULL | Charge is between 70% and 100%. |

## Remarks

The *BatteryLevel* value is valid only for a device that has a known battery type.

This structure is used by the [XInputGetBatteryInformation](https://docs.xbox.com/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md) function.

For more information, see [The XInputOnGameInput wrapper](https://docs.xbox.com/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection).

## Requirements

**Header:** XInputOnGameInput.h

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[Porting from XInput to GameInput](https://docs.xbox.com/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetBatteryInformation](https://docs.xbox.com/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputOnGameInput (API contents)](https://docs.xbox.com/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_STATE](https://docs.xbox.com/reference/input/xinputongameinput/structs/xinput_state.md)
- [XINPUT_VIBRATION](https://docs.xbox.com/reference/input/xinputongameinput/structs/xinput_vibration.md)
- [XINPUT_CAPABILITIES](https://docs.xbox.com/reference/input/xinputongameinput/structs/xinput_capabilities.md)