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

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="membersSection" />

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

<a id="remarksSection" />

## 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](/pt-BR/reference/input/xinputongameinput/functions/xinputgetbatteryinformation).

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XInputOnGameInput.h

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

<a id="seealsoSection" />

## Confira também

[Portabilidade do XInput para o GameInput](/pt-BR/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/pt-BR/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_BATTERY_INFORMATION](/reference/input/xinputongameinput/structs/xinput_battery_information.md)
- [XInputGetBatteryInformation](/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)