메인 콘텐츠로 건너뛰기
입력 장치에 대한 루트 장치 노드의 애플리케이션 로컬 ID를 가져옵니다.

구문

매개변수

deviceRootId   _Out_
형식: APP_LOCAL_DEVICE_ID*
루트 장치 노드의 애플리케이션 로컬 ID를 받습니다.

반환값

형식: void

설명

루트 장치 ID는 복합 장치의 루트 장치 노드를 식별하는 애플리케이션 로컬 ID입니다. 이를 통해 애플리케이션이 개별 장치 간의 관계를 파악할 수 있습니다. 예를 들어, 일부 게이밍 키보드는 여러 키보드 노드를 가진 복합 장치로 자신을 노출하여 동시 8개 키 입력이라는 레거시 USB 제한을 우회합니다. 이러한 노드는 “시스템” 키보드로 병합되므로 일반적으로 사용자에게는 투명합니다. 그러나 GameInput API로 키보드별 입력을 처리할 때 이 관계를 이해하면 애플리케이션이 기능을 키 입력에 매핑할 때 부적절한 가정(예: 키 입력이 항상 특정 장치에서 온다는 가정)을 피하는 데 도움이 됩니다. 같은 루트 장치 ID를 보고하는 장치는 동일한 복합 장치에 속합니다. 장치가 복합 장치의 여러 인터페이스 중 하나가 아니면 루트 장치 ID는 IGameInputDevice::GetDeviceId가 반환하는 ID와 동일합니다. GameInput v3 이하에서는 IGameInputDevice::GetDeviceInfo가 반환하는 GameInputDeviceInfo 구조체의 deviceRootId 멤버에서 이 정보를 얻을 수 있었습니다.

요구 사항

헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
IGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

버전 기록

마지막 수정일 2026년 11월 6일