Skip to main content

XINPUT_KEYSTROKE

XInputGetKeystroke 함수가 반환하는 키 입력 데이터를 설명합니다.

구문

멤버

VirtualKey
형식: WORD
키, 버튼 또는 스틱 이동의 가상 키 코드입니다. Unicode
형식: WCHAR
이 멤버는 사용되지 않으며, 값은 0입니다. Flags
형식: WORD
입력 이벤트 시의 키보드 상태를 나타내는 플래그입니다. 이 멤버는 다음 플래그의 임의 조합이 될 수 있습니다. UserIndex
형식: BYTE
헤드셋과 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. HidCode
형식: BYTE
입력에 해당하는 HID(Human Interface Device) 코드입니다. 해당 HID 코드가 없으면 이 값은 0입니다.

설명

이 구조체는 XInputGetKeystroke 함수에서 사용됩니다. 향후 장치는 현재 장치에서 지원되지 않고 현재 정의되지 않은 HID 코드와 가상 키 값을 반환할 수 있습니다. 애플리케이션은 이러한 예기치 않은 값을 무시해야 합니다. 가상 키 코드는 키가 매핑될 수 있는 문자(없을 수도 있음)가 아니라 키보드의 특정 물리적 키를 나타내는 바이트 값입니다. 가상 키가 눌린 시점의 키보드 상태에 따라 보고되는 문자가 수정됩니다. 예를 들어 VK_4는 Shift 키의 상태에 따라 “4” 또는 ”$“를 나타낼 수 있습니다. 보고된 키보드 이벤트에는 이벤트를 발생시킨 가상 키, 키가 눌렸는지 놓였는지(또는 반복 중인지) 여부, 이벤트 발생 시의 키보드 상태가 포함됩니다. 키보드 상태는 Ctrl, Alt 또는 Shift 키가 눌려 있는지 여부를 나타냅니다. 유효한 가상 키 코드(VK_xxx)는 XInput.h에 정의되어 있습니다. 키 누름을 나타내는 코드 외에도 다음 코드는 컨트롤러 입력을 나타냅니다. 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

헤더: XInputOnGameInput.h 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일