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

# SendGamepadReportEx

> IXtfInputClient::SendGamepadReportEx

# IXtfInputClient::SendGamepadReportEx

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

## 구문

```cpp theme={null}
HRESULT SendGamepadReportEx(  
         UINT64 controllerId,  
         GAMEPAD_REPORT_EX 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\_EX](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)

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

### 반환 값

형식: HRESULT

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

## 설명

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

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

## 요구 사항

**헤더:** XtfInput.h

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

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

## 함께 보기

[XtfInput](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[GAMEPAD\_REPORT\_EX](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.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_EX](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [IXtfInputClient 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [SendGamepadReportWithAudio](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [SendGamepadReport](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [GAMEPAD_REPORT structure](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)