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

Descreve o tipo e o estado de carga de uma bateria.

## Sintaxe

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

### Membros

*BatteryType*\
Tipo: BYTE

O tipo da bateria, como um dos seguintes valores:

| Valor | Descrição |
| - | - |
| BATTERY\_TYPE\_DISCONNECTED | O dispositivo não está conectado. |
| BATTERY\_TYPE\_WIRED | O dispositivo é com fio e não tem bateria. |
| BATTERY\_TYPE\_ALKALINE | O dispositivo tem uma bateria alcalina. |
| BATTERY\_TYPE\_NIMH | O dispositivo tem uma bateria de hidreto metálico de níquel (NiMH). |
| BATTERY\_TYPE\_UNKNOWN | O dispositivo tem um tipo de bateria desconhecido. |

*BatteryLevel*\
Tipo: BYTE

O estado de carga da bateria, em comparação com sua capacidade de carga total, como um dos seguintes valores:

| Valor | Descrição |
| - | - |
| BATTERY\_LEVEL\_EMPTY | A carga está entre zero e 10%. |
| BATTERY\_LEVEL\_LOW | A carga está entre 10% e 40%. |
| BATTERY\_LEVEL\_MEDIUM | A carga está entre 40% e 70%. |
| BATTERY\_LEVEL\_FULL | A carga está entre 70% e 100%. |

## Comentários

O valor *BatteryLevel* é válido apenas para um dispositivo que tenha um tipo de bateria conhecido.

Essa estrutura é usada pela função [XInputGetBatteryInformation](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md).

Para obter mais informações, consulte [O wrapper XInputOnGameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection).

## Requisitos

**Cabeçalho:** XInputOnGameInput.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Portabilidade do XInput para o GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetBatteryInformation](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputOnGameInput (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_CAPABILITIES](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XINPUT_KEYSTROKE](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_keystroke.md)