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

> XINPUT_STATE

# XINPUT\_STATE

Descreve o estado de um controle.

## Sintaxe

```cpp theme={null}
typedef struct XINPUT_STATE {  
    DWORD dwPacketNumber;  
    XINPUT_GAMEPAD Gamepad;  
} XINPUT_STATE  
```

### Membros

*dwPacketNumber*\
Tipo: DWORD

Número do pacote de estado. O número do pacote indica se o estado do controle foi alterado. Se o valor for o mesmo em objetos `XINPUT_STATE` retornados sequencialmente, o estado do controle não foi alterado.

*Gamepad*\
Tipo: [XINPUT\_GAMEPAD](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad.md)

Objeto [XINPUT\_GAMEPAD](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad.md) que contém o estado atual de um controle.

## Comentários

O valor de *dwPacketNumber* é incrementado somente se o estado do controle tiver sido alterado desde a última sondagem do controle.

Essa estrutura é usada pelas funções [XInputGetState](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetstate.md) e [XInputGetStateWithToken](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.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

- [XInputGetState](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XInputGetStateWithToken](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md)
- [XInputOnGameInput (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_VIBRATION](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_vibration.md)