다음을 통해 공유

XINPUT_KEYSTROKE 구조체(xinput.h)

  • 아티클

XInputGetKeystroke에서 반환된 키 입력 데이터를 지정합니다.

구문

typedef struct _XINPUT_KEYSTROKE {
  WORD  VirtualKey;
  WCHAR Unicode;
  WORD  Flags;
  BYTE  UserIndex;
  BYTE  HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;

멤버

VirtualKey

키, 단추 또는 스틱 이동의 가상 키 코드입니다. 유효한 가상 키(VK_xxx) 코드 목록은 XInput.h를 참조하세요. 또한 설명을 참조하세요.

Unicode

이 멤버는 사용되지 않으며 값은 0입니다.

Flags

입력 이벤트 당시의 키보드 상태를 나타내는 플래그입니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

값 Description
XINPUT_KEYSTROKE_KEYDOWN 키를 눌렀습니다. 
XINPUT_KEYSTROKE_KEYUP 키가 해제되었습니다. 
XINPUT_KEYSTROKE_REPEAT 보관된 키의 반복입니다. 

UserIndex

디바이스와 연결된 로그인된 게이머의 인덱스입니다. 0~3 범위의 값일 수 있습니다.

HidCode

입력에 해당하는 HID 코드입니다. 해당 HID 코드가 없으면 이 값은 0입니다.

설명

향후 디바이스는 현재 디바이스에서 지원되지 않고 현재 정의되지 않은 HID 코드 및 가상 키 값을 반환할 수 있습니다. 애플리케이션은 이러한 예기치 않은 값을 무시해야 합니다.

가상 키 코드는 키보드 상태에 따라 키를 매핑할 수 있는 문자나 문자(없음)가 아니라 키보드의 특정 물리적 키를 나타내는 바이트 값입니다. 가상 키를 누를 때의 키보드 상태는 보고된 문자를 수정합니다. 예를 들어 VK_4 SHIFT 키의 상태에 따라 "4" 또는 "$"를 나타낼 수 있습니다.

보고된 키보드 이벤트에는 이벤트를 발생시킨 가상 키, 키를 누르거나 놓었는지(또는 반복 중인지) 및 이벤트 당시의 키보드 상태가 포함됩니다. 키보드 상태에는 CTRL, Alt 또는 Shift 키가 다운되었는지 여부에 대한 정보가 포함됩니다.

키보드 이벤트가 유니코드 문자를 나타내는 경우(예: "A" 키 누르기) 유니코드 멤버에 해당 문자가 포함됩니다. 그렇지 않으면 유니코드 에 값 0이 포함됩니다.

유효한 가상 키(VK_xxx) 코드는 XInput.h에 정의되어 있습니다. 키 누름을 나타내는 코드 외에도 다음 코드는 컨트롤러 입력을 나타냅니다.

값 Description
VK_PAD_A 단추
VK_PAD_B B 단추
VK_PAD_X X 단추
VK_PAD_Y Y 단추
VK_PAD_RSHOULDER 오른쪽 어깨 단추
VK_PAD_LSHOULDER 왼쪽 어깨 단추
VK_PAD_LTRIGGER 왼쪽 트리거
VK_PAD_RTRIGGER 오른쪽 트리거
VK_PAD_DPAD_UP 방향 패드 위로
VK_PAD_DPAD_DOWN 방향 패드 아래쪽
VK_PAD_DPAD_LEFT 왼쪽 방향 패드
VK_PAD_DPAD_RIGHT 방향 패드 오른쪽
VK_PAD_START 시작 단추
VK_PAD_BACK 뒤로 단추
VK_PAD_LTHUMB_PRESS 왼쪽 엄지스틱 클릭
VK_PAD_RTHUMB_PRESS 오른쪽 엄지스틱 클릭
VK_PAD_LTHUMB_UP 왼쪽 엄지스틱 위로
VK_PAD_LTHUMB_DOWN 왼쪽 엄지스틱 아래로
VK_PAD_LTHUMB_RIGHT 왼쪽 엄지스틱 오른쪽
VK_PAD_LTHUMB_LEFT 왼쪽 엄지스틱 왼쪽
VK_PAD_LTHUMB_UPLEFT 왼쪽 엄지스틱 위쪽 및 왼쪽
VK_PAD_LTHUMB_UPRIGHT 왼쪽 엄지스틱 위쪽 및 오른쪽
VK_PAD_LTHUMB_DOWNRIGHT 왼쪽 엄지스틱 아래쪽 및 오른쪽
VK_PAD_LTHUMB_DOWNLEFT 왼쪽 엄지스틱 아래쪽 및 왼쪽
VK_PAD_RTHUMB_UP 오른쪽 섬스틱(thumbstick) 위쪽
VK_PAD_RTHUMB_DOWN 오른쪽 섬스틱(thumbstick) 아래쪽
VK_PAD_RTHUMB_RIGHT 오른쪽 섬스틱(thumbstick) 오른쪽
VK_PAD_RTHUMB_LEFT 오른쪽 섬스틱(thumbstick) 왼쪽
VK_PAD_RTHUMB_UPLEFT 오른쪽 엄지스틱 위쪽 및 왼쪽
VK_PAD_RTHUMB_UPRIGHT 오른쪽 엄지스틱 위쪽 및 오른쪽
VK_PAD_RTHUMB_DOWNRIGHT 오른쪽 엄지스틱 아래쪽 및 오른쪽
VK_PAD_RTHUMB_DOWNLEFT 오른쪽 엄지스틱 아래쪽 및 왼쪽

요구 사항

요구 사항 값
헤더 xinput.h

추가 정보

XInputGetKeystroke