Skip to main content

XINPUT_GAMEPAD

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

구문

멤버

wButtons
형식: WORD
장치의 디지털 버튼에 대한 비트마스크입니다. 설정된 비트는 해당 버튼이 눌려 있음을 나타냅니다. 설정되었지만 위에 정의되지 않은 비트는 예약되어 있으며, 그 상태는 정의되지 않습니다. 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 구조체에서 사용됩니다. 버튼과 게임 기능 간의 특정 매핑은 게임 유형에 따라 다릅니다. bLeftTriggerbRightTrigger가 눌린 것으로 등록되기 위해 초과해야 하는 값으로 상수 XINPUT_GAMEPAD_TRIGGER_THRESHOLD를 사용할 수 있습니다. 이는 선택 사항이지만 종종 바람직합니다.

요구 사항

헤더: XInputOnGameInput.h 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput을 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일