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

# GAMEPAD_REPORT structure

> GAMEPAD_REPORT structure

# GAMEPAD\_REPORT structure

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

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

##### Members

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

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

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

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

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

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

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

## Remarks

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

## Requirements

**Header:** xtfinput.h

**Library:** xtfinput.lib

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

## See also

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


## Related topics

- [XtfInput (API 콘텐츠)](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)
- [SendGamepadReport](https://docs.xbox.com/ko/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.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)