XINPUT_KEYSTROKE
XInputGetKeystroke 함수에서 반환된 키 입력 데이터에 대해 설명합니다.
구문
typedef struct XINPUT_KEYSTROKE {
WORD VirtualKey;
WCHAR Unicode;
WORD Flags;
BYTE UserIndex;
BYTE HidCode;
} XINPUT_KEYSTROKE
멤버
VirtualKey
형식: WORD
키, 버튼 또는 스틱 이동의 가상 키 코드입니다.
Unicode
형식: WCHAR
이 멤버는 사용되지 않으며 값은 0입니다.
Flags
형식: WORD
입력 이벤트가 발생했을 때의 키보드 상태를 나타내는 플래그입니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.
| 값 | 설명 |
|---|---|
| XINPUT_KEYSTROKE_KEYDOWN | 키를 눌렀습니다. |
| XINPUT_KEYSTROKE_KEYUP | 키를 놓았습니다. |
| XINPUT_KEYSTROKE_REPEAT | 눌린 키의 반복입니다. |
UserIndex
형식: BYTE
헤드셋과 연결된 게이머의 인덱스이며, 값 범위는 0에서 XUSER_MAX_COUNT - 1 사이입니다.
HidCode
형식: BYTE
입력에 해당하는 HID(휴먼 인터페이스 디바이스) 코드입니다. 해당 HID 코드가 없는 경우 이 값은 0입니다.
설명
이 구조는 XInputGetKeystroke 함수에서 사용됩니다.
향후 디바이스는 현재 디바이스에서 지원되지 않고 지금은 정의되지 않은 HID 코드 및 가상 키 값을 반환할 수 있습니다. 응용 프로그램은 이러한 예기치 않은 값을 무시해야 합니다.
가상 키 코드는 키보드 상태에 따라 키를 매핑할 수 있는 문자가 아닌 키보드의 특정 물리적 키를 나타내는 바이트 값입니다. 가상 키를 누를 때의 키보드 상태는 보고된 문자를 수정합니다. 예를 들어 Shift 키의 상태에 따라 VK_4은(는) “4” 또는 “$”를 나타낼 수 있습니다.
보고된 키보드 이벤트에는 이벤트를 발생시킨 가상 키, 키를 눌렀는지 또는 놓았는지(또는 반복하는지) 여부, 이벤트 당시의 키보드 상태가 포함됩니다. 키보드 상태는 Ctrl, Alt 또는 Shift 키를 눌렀는지 여부를 나타냅니다.
유효한 가상 키 코드(VK_xxx)는 XInput.h에 정의되어 있습니다. 키 누르기를 나타내는 코드 외에도 다음 코드는 컨트롤러 입력을 나타냅니다.
| 값 | 설명 |
|---|---|
| VK_PAD_A | 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 | 오른쪽 엄지스틱 위로 |
| VK_PAD_RTHUMB_DOWN | 오른쪽 엄지스틱 아래로 |
| VK_PAD_RTHUMB_RIGHT | 오른쪽 엄지스틱 오른쪽으로 |
| VK_PAD_RTHUMB_LEFT | 오른쪽 엄지스틱 왼쪽으로 |
| VK_PAD_RTHUMB_UPLEFT | 오른쪽 엄지스틱 왼쪽 위로 |
| VK_PAD_RTHUMB_UPRIGHT | 오른쪽 엄지스틱 오른쪽 위로 |
| VK_PAD_RTHUMB_DOWNRIGHT | 오른쪽 엄지스틱 오른쪽 아래로 |
| VK_PAD_RTHUMB_DOWNLEFT | 오른쪽 엄지스틱 왼쪽 아래로 |
자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.
요구 사항
헤더: XInputOnGameInput.h
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔