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

# SendGamepadReport

> Método IXtfInputClient::SendGamepadReport

# Método IXtfInputClient::SendGamepadReport

Envia um relatório de estado do controle para o console.

## Sintaxe

```cpp theme={null}
public:
HRESULT SendGamepadReport(
         UINT64 controllerId,
         GAMEPAD_REPORT report
)  
```

### Parâmetros

*controllerId*\
Tipo: UINT64

O identificador de dispositivo deste [IXtfInputClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md).\
A ID do controle é a ID do controle retornada por [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md).

*report*\
Tipo: GAMEPAD\_REPORT

O estado do controle a ser relatado

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

## Comentários

O método **SendGameReport** envia um estado do controle representado por um [GAMEPAD\_REPORT](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md) 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). Você precisará enviar vários estados para simular um único pressionamento e liberação de botão. Para simular o pressionamento de um botão, chame **SendGamepadReport** com o sinalizador apropriado definido em [GAMEPAD\_REPORT.Buttons](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md) e, em seguida, chame **SendGamepadReport** novamente, com [GAMEPAD\_REPORT.Buttons](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md) definido como [GAMEPAD\_BUTTONS::NONE](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md).

**SendGamepadReport** pode ser chamado a 60 Hz para imitar dados provenientes de um controle físico.

## 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)\
[GAMEPAD\_REPORT](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.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

- [Estrutura GAMEPAD_REPORT](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [Interface IXtfInputClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.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)