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

# IXtfInputClient::SendGamepadReport 메서드

> IXtfInputClient::SendGamepadReport 메서드

# IXtfInputClient::SendGamepadReport 메서드

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

<a id="syntaxSection" />

## 구문

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

<a id="ID4EG" />

### 매개 변수

*controllerId*\
형식: UINT64

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

*report*\
형식: GAMEPAD\_REPORT

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

<a id="ID4EP" />

### 반환 값

형식: HRESULT

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

<a id="remarks" />

## 설명

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

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

<a id="requirements" />

## 요구 사항

**헤더:** xtfinput.h

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

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

## 함께 보기

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


## Related topics

- [IXtfInputClient::SendGamepadReportEx](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [IXtfInputClient::ConnectGamepad 메서드](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::SendGamepadReportWithAudio](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [IXtfInputClient::DisconnectGamepad 메서드](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::DisconnectAllGamepads 메서드](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)
