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

> IXtfInputClient::SendGamepadReport 메서드

# IXtfInputClient::SendGamepadReport 메서드

컨트롤러 상태 보고서를 콘솔에 보냅니다.

## 구문

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

### 매개 변수

*controllerId*\
형식: UINT64

이 [IXtfInputClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)의 디바이스 식별자입니다.\
컨트롤러 ID는 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)에서 반환한 컨트롤러 ID입니다.

*report*\
형식: GAMEPAD\_REPORT

보고할 컨트롤러 상태입니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## 설명

**SendGameReport** 메서드는 [GAMEPAD\_REPORT](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)로 표현된 컨트롤러 상태를 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)에서 만든 가상 컨트롤러로 보냅니다. 단일 단추 누름과 놓음을 시뮬레이션하려면 여러 상태를 보내야 합니다. 단추 누름을 시뮬레이션하려면 [GAMEPAD\_REPORT.Buttons](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)에 적절한 플래그를 설정하여 **SendGamepadReport**를 호출한 다음, [GAMEPAD\_REPORT.Buttons](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)를 [GAMEPAD\_BUTTONS::NONE](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md)으로 설정하여 **SendGamepadReport**를 다시 호출합니다.

**SendGamepadReport**는 60Hz로 호출하여 물리적 컨트롤러에서 오는 데이터를 모방할 수 있습니다.

## 요구 사항

**헤더:** xtfinput.h

**라이브러리:** xtfinput.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

## 함께 보기

[XtfInput](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[GAMEPAD\_REPORT](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [GAMEPAD_REPORT structure](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [ConnectGamepad](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [SendGamepadReportEx](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [SendGamepadReportWithAudio](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)