Skip to main content
API는 GameInput 마우스 및 키보드 장치를 별도로 정의합니다. 이러한 장치는 Windows에서 특별한 의미를 가지며 다른 곳에서 다룹니다. 자세한 내용은 키보드 및 마우스 HID 클라이언트 드라이버 개발을 참조하세요.
GameInput은 컨트롤러, 게임패드, 플라이트 스틱, 아케이드 스틱, 레이싱 휠, UI 내비게이션 컨트롤러 등 다양한 장치를 나타냅니다. 각 장치 유형에는 해당 장치와 상호 작용하는 데 사용할 수 있는 고유한 인터페이스가 있습니다. 하드웨어 장치가 이러한 인터페이스 중 하나에 표시되는지 여부는 장치가 게이밍 입력 컨트롤러에 대한 기존 Windows 드라이버 프로토콜 중 하나를 준수하는지, 아니면 일반 HID 장치인지에 따라 달라집니다. XInput 호환 장치의 경우, GameInput API는 이러한 장치를 컨트롤러, 게임패드, UI 내비게이션 컨트롤러로 열거합니다. 이러한 장치의 매핑은 엄격히 프로토콜에 의해 결정되며, 프로토콜은 추가 버튼을 지원하지 않습니다. 이러한 장치는 듀얼 또는 쿼드 럼블 효과도 지원합니다. 이러한 효과는 왼쪽과 오른쪽 모터, 그리고 왼쪽과 오른쪽 트리거에 해당합니다. XInput에는 XUSB, XInputHID, Game Input Protocol(GIP)의 세 가지 주요 유선 프로토콜이 있습니다. 콘솔에서는 시스템이 GIP 장치만 지원합니다. 이러한 모든 프로토콜에 대한 자세한 내용은 하드웨어 장치용 XInput API 문서를 참조하세요. PC에서는 장치가 XInputHID 드라이버와 인터페이스해야 합니다. 게임패드를 제외한 기타 Game Input Protocol(GIP) 장치의 경우, GameInput API는 연결 시 제공되는 메타데이터를 기반으로 이러한 장치를 플라이트 스틱, 아케이드 스틱, 레이싱 휠 또는 UI 내비게이션 컨트롤러로 열거합니다. 이 동작은 콘솔과 PC 모두에서 동일합니다. 자세한 내용은 Game Input Protocol(GIP) 문서를 참조하세요. HID 장치의 경우, GameInput은 장치가 운영 체제에 자신을 나타내는 방식에 있어 더 큰 유연성을 제공합니다. 이 유연성 덕분에 HID 장치는 표준 게임 컨트롤러 프로토콜이 정의하는 범위를 넘어서는 광범위한 기능과 성능을 잠재적으로 노출할 수 있습니다. 예를 들어 레이싱 휠 장치는 잠재적으로 GameInput에 게임패드와 플라이트 스틱으로 자신을 표현할 수 있습니다. 장치에서 사용 가능한 버튼, 스위치, 축의 전체 목록은 장치의 HID 보고서 디스크립터로 정의되며, GetControllerButtonState, GetControllerButtonCount 및 축 또는 스위치를 얻는 동일한 호출로부터 IGameInputReading 인터페이스를 통해 노출됩니다. 이러한 기능을 게임패드 또는 레이싱 휠과 같은 다른 인터페이스에 매핑하기 위해 GameInput은 Windows 레지스트리의 일련의 매핑을 사용합니다. Windows.Gaming.Input(WGI) API도 이러한 매핑을 공유합니다. 자세한 내용은 게임 컨트롤러용 레지스트리 데이터를 참조하세요. 독립 하드웨어 공급업체(IHV)는 드라이버 설치의 일부로 HKLM\SYSTEM\CurrentControlSet\Control\GameInput\Devices 경로에 자체 레지스트리 매핑을 추가할 수 있습니다. GameInput API는 게임과 함께 재배포하는 API의 이후 릴리스에서 일반 장치에 대한 기본 매핑을 주기적으로 추가합니다. IHV 매핑은 기본 매핑보다 우선합니다. API와 함께 패키징된 매핑은 HKLM\SOFTWARE\Microsoft\GameInputRedist에서 확인할 수 있습니다.

함께 보기

GameInput 개요 XInput 게임 컨트롤러 API Game Input Protocol(GIP) / XInputHID 드라이버 문서(다운로드) 게임 컨트롤러용 레지스트리 데이터
마지막 수정일 2026년 8월 13일