XINPUT_GAMEPAD
컨트롤러의 현재 상태를 설명합니다.
구문
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 구조체에서 사용합니다.
게임 기능에 대한 특정 버튼 매핑은 게임 유형에 따라 다릅니다.
상수 XINPUT_GAMEPAD_TRIGGER_THRESHOLD는 bLeftTrigger 및 bRightTrigger가 누름으로 등록되려면 초과해야 하는 값으로 사용될 수 있습니다. 이 옵션은 선택 사항이지만, 대체로 권장됩니다.
요구 사항
헤더: XInputOnGameInput.h
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔