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

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

UserIndex

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

HidCode

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

설명

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

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

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

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

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

요구 사항

추가 정보

XInputGetKeystroke