XINPUT_GAMEPAD 구조체(xinput.h)

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

구문

typedef struct _XINPUT_GAMEPAD {
  WORD  wButtons;
  BYTE  bLeftTrigger;
  BYTE  bRightTrigger;
  SHORT sThumbLX;
  SHORT sThumbLY;
  SHORT sThumbRX;
  SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;

멤버

wButtons

다음과 같이 디바이스 디지털 단추의 비트 마스크입니다. set 비트는 해당 단추를 눌렀다는 것을 나타냅니다.

디바이스 단추	비트 마스크
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

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

bRightTrigger

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

sThumbLX

왼쪽 엄지스틱 x축 값입니다. 각 엄지스틱 축 멤버는 엄지스틱의 위치를 설명하는 -32768에서 32767 사이의 부가 값입니다. 값이 0인 경우 가운데가 지정됩니다. 음수 값은 아래로 또는 왼쪽을 나타냅니다. 양수 값은 오른쪽 또는 을 나타냅니다. 상수 XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE 또는 XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE 양수 및 음수 값으로 사용하여 엄지스틱 입력을 필터링할 수 있습니다.

sThumbLY

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

sThumbRX

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

sThumbRY

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

설명

이 구조체는 컨트롤러 상태의 변경 내용을 폴링할 때 XINPUT_STATE 구조체에서 사용됩니다.

단추와 게임 함수의 특정 매핑은 게임 유형에 따라 달라집니다.

상수 XINPUT_GAMEPAD_TRIGGER_THRESHOLD bLeftTrigger 및 bRightTrigger 가 누름으로 등록하는 것보다 커야 하는 값으로 사용할 수 있습니다. 이는 선택 사항이지만 종종 바람직합니다. 컨트롤러 단추는 크로스토크를 매니페스트하지 않습니다.

요구 사항

요구 사항	값
헤더	xinput.h

추가 정보

XINPUT_STATE

XInput 구조체

XInputGetState