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

# XINPUT_GAMEPAD

> XINPUT_GAMEPAD

# XINPUT\_GAMEPAD

컨트롤러의 현재 상태를 설명합니다.

## 구문

```cpp theme={null}
typedef struct XINPUT_GAMEPAD {  
    WORD wButtons;  
    BYTE bLeftTrigger;  
    BYTE bRightTrigger;  
    SHORT sThumbLX;  
    SHORT sThumbLY;  
    SHORT sThumbRX;  
    SHORT sThumbRY;  
} XINPUT_GAMEPAD  
```

### 멤버

*wButtons*\
형식: WORD

장치의 디지털 버튼에 대한 비트마스크입니다. 설정된 비트는 해당 버튼이 눌려 있음을 나타냅니다.

| 장치 버튼                            | 비트마스크  |
| -------------------------------- | ------ |
| XINPUT\_GAMEPAD\_DPAD\_UP        | 0x0001 |
| XINPUT\_GAMEPAD\_DPAD\_DOWN      | 0x0002 |
| XINPUT\_GAMEPAD\_DPAD\_LEFT      | 0x0004 |
| XINPUT\_GAMEPAD\_DPAD\_RIGHT     | 0x0008 |
| XINPUT\_GAMEPAD\_START           | 0x0010 |
| XINPUT\_GAMEPAD\_BACK            | 0x0020 |
| XINPUT\_GAMEPAD\_LEFT\_THUMB     | 0x0040 |
| XINPUT\_GAMEPAD\_RIGHT\_THUMB    | 0x0080 |
| XINPUT\_GAMEPAD\_LEFT\_SHOULDER  | 0x0100 |
| XINPUT\_GAMEPAD\_RIGHT\_SHOULDER | 0x0200 |
| XINPUT\_GAMEPAD\_A               | 0x1000 |
| XINPUT\_GAMEPAD\_B               | 0x2000 |
| XINPUT\_GAMEPAD\_X               | 0x4000 |
| XINPUT\_GAMEPAD\_Y               | 0x8000 |

설정되었지만 위에 정의되지 않은 비트는 예약되어 있으며, 그 상태는 정의되지 않습니다.

*bLeftTrigger*\
형식: BYTE

왼쪽 트리거 아날로그 컨트롤의 현재 값입니다. 값은 0에서 255 사이입니다.

*bRightTrigger*\
형식: BYTE

오른쪽 트리거 아날로그 컨트롤의 현재 값입니다. 값은 0에서 255 사이입니다.

*sThumbLX*\
형식: SHORT

왼쪽 엄지 스틱의 x축 값입니다. 각 엄지 스틱 축 멤버는 -32768과 32767 사이의 부호 있는 값이며, 엄지 스틱의 위치를 나타냅니다. 값 0은 중앙이고, 음수 값은 아래쪽 또는 왼쪽을 의미하며, 양수 값은 위쪽 또는 오른쪽을 의미합니다. 상수 XINPUT\_GAMEPAD\_LEFT\_THUMB\_DEADZONE 및 XINPUT\_GAMEPAD\_RIGHT\_THUMB\_DEADZONE은 엄지 스틱 입력을 필터링하기 위한 양수 및 음수 값으로 사용할 수 있습니다.

*sThumbLY*\
형식: SHORT

왼쪽 엄지 스틱의 y축 값이며, -32768에서 32767 사이입니다.

*sThumbRX*\
형식: SHORT

오른쪽 엄지 스틱의 x축 값이며, -32768에서 32767 사이입니다.

*sThumbRY*\
형식: SHORT

오른쪽 엄지 스틱의 y축 값이며, -32768에서 32767 사이입니다.

## 설명

이 구조체는 컨트롤러 상태의 변경 사항을 폴링하는 동안 [XINPUT\_STATE](/reference/input/xinputongameinput/structs/xinput_state) 구조체에서 사용됩니다.

버튼과 게임 기능 간의 특정 매핑은 게임 유형에 따라 다릅니다.

*bLeftTrigger* 및 *bRightTrigger*가 눌린 것으로 등록되기 위해 초과해야 하는 값으로 상수 XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD를 사용할 수 있습니다. 이는 선택 사항이지만 종종 바람직합니다.

## 요구 사항

**헤더:** XInputOnGameInput.h

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 참고 항목

[XInput을 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_STATE](/ko/reference/input/xinputongameinput/structs/xinput_state.md)
- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_CAPABILITIES](/ko/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputGetBatteryInformation](/ko/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputGetCapabilities](/ko/reference/input/xinputongameinput/functions/xinputgetcapabilities.md)