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

# Estrutura GAMEPAD_REPORT

> Estrutura GAMEPAD_REPORT

# Estrutura GAMEPAD\_REPORT

Um instantâneo do estado de um controle.

## Sintaxe

```cpp theme={null}
typedef struct GAMEPAD_REPORT {
    UINT16 Buttons;
    UINT16 LeftTrigger;
    UINT16 RightTrigger;
    INT16 LeftThumbstickX;
    INT16 LeftThumbstickY;
    INT16 RightThumbstickX;
    INT16 RightThumbstickY;
} GAMEPAD_REPORT, *PGAMEPAD_REPORT;  
```

##### Membros

**Buttons**\
Uma combinação de valores de sinalizador [GAMEPAD\_BUTTONS](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md) que representam o estado dos botões do controle.

**LeftTrigger**\
Valor entre 0 e 1023 que indica o quanto o gatilho esquerdo está pressionado.

**RightTrigger**\
Valor entre 0 e 1023 que indica o quanto o gatilho direito está pressionado.

**LeftThumbstickX**\
Valor entre -32768 e 32767 que indica a posição do direcional analógico esquerdo no eixo x.

**LeftThumbstickY**\
Valor entre -32768 e 32767 que indica a posição do direcional analógico esquerdo no eixo y.

**RightThumbstickX**\
Valor entre -32768 e 32767 que indica a posição do direcional analógico direito no eixo x.

**RightThumbstickY**\
Valor entre -32768 e 32767 que indica a posição do direcional analógico direito no eixo y.

## Comentários

**GAMEPAD\_REPORT** é usado para enviar o estado desejado de um controle simulado para um console de desenvolvimento. Você enviará estados individuais do controle para o console usando [IXtfInputClient::SendGamepadReport](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md). Fazendo isso repetidamente, você poderá simular uma sequência de entradas do controle no console de desenvolvimento. Você precisará enviar relatórios de jogo para um controle virtual criado por [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md).

## Requisitos

**Cabeçalho:** xtfinput.h

**Biblioteca:** xtfinput.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[XtfInput](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[IXtfInputClient::SendGamepadReport](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [XtfInput (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)
- [GAMEPAD_REPORT_EX](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [SendGamepadReport](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [SendGamepadReportEx](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [SendGamepadReportWithAudio](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)