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

# GAMEPAD_REPORT structure

> GAMEPAD_REPORT structure

# GAMEPAD\_REPORT structure

컨트롤러 상태의 스냅샷입니다.

<a id="syntaxSection" />

## Syntax

```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;  
```

<a id="ID4EG" />

##### Members

**Buttons**\
컨트롤러의 버튼 상태를 나타내는 [GAMEPAD\_BUTTONS](/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t) 플래그 값의 조합입니다.

**LeftTrigger**\
왼쪽 트리거가 얼마나 당겨졌는지를 나타내는 0에서 1023 사이의 값입니다.

**RightTrigger**\
오른쪽 트리거가 얼마나 당겨졌는지를 나타내는 0에서 1023 사이의 값입니다.

**LeftThumbstickX**\
왼쪽 썸스틱의 x축 위치를 나타내는 -32768에서 32767 사이의 값입니다.

**LeftThumbstickY**\
왼쪽 썸스틱의 y축 위치를 나타내는 -32768에서 32767 사이의 값입니다.

**RightThumbstickX**\
오른쪽 썸스틱의 x축 위치를 나타내는 -32768에서 32767 사이의 값입니다.

**RightThumbstickY**\
오른쪽 썸스틱의 y축 위치를 나타내는 -32768에서 32767 사이의 값입니다.

<a id="requirements" />

## Remarks

**GAMEPAD\_REPORT**는 시뮬레이션된 컨트롤러의 원하는 상태를 개발 콘솔로 보내는 데 사용됩니다. [IXtfInputClient::SendGamepadReport](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m)를 사용하여 컨트롤러의 개별 상태를 콘솔에 보냅니다. 이를 반복적으로 수행하면 개발 콘솔에서 일련의 컨트롤러 입력을 시뮬레이션할 수 있습니다. [IXtfInputClient::ConnectGamepad](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m)로 생성된 가상 컨트롤러에 게임 리포트를 보내야 합니다.

## Requirements

**Header:** xtfinput.h

**Library:** xtfinput.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

## See also

[XtfInput](/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n)\
[IXtfInputClient::SendGamepadReport](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m)\
[IXtfInputClient::ConnectGamepad](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m)


## Related topics

- [GAMEPAD_REPORT_EX](/ko/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [IXtfInputClient::SendGamepadReport 메서드](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::SendGamepadReportEx](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [IXtfInputClient::SendGamepadReportWithAudio](/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [GAMEPAD_BUTTONS 열거형](/ko/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md)