메인 콘텐츠로 건너뛰기
입력 장치를 고유하게 식별하는 애플리케이션 로컬 ID를 가져옵니다.

구문

매개변수

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

반환값

형식: void

설명

장치 ID는 애플리케이션 로컬 ID로, 장치를 고유하게 식별하는 256비트 해시 값입니다. 이 ID는 장치가 동일한 USB 포트에 연결되어 있는 한, 애플리케이션 실행이나 시스템 재부팅 간에도 특정 장치에 대해 동일하게 유지됩니다. 해시는 호출 애플리케이션과 시스템에 특정한 정보를 부분적으로 사용하여 생성되므로, 동일한 장치라도 애플리케이션마다 ID가 다릅니다. ID가 안정적이므로 사용자가 선호하는 컨트롤러와 같은 장치를 기억하기 위해 ID를 저장해 두었다가, 나중에 IGameInput::FindDeviceFromId를 호출하여 일치하는 장치 개체를 조회할 수 있습니다. 복합 장치의 여러 인터페이스 중 하나인 장치의 경우 IGameInputDevice::GetDeviceRootId를 사용하여 루트 장치의 ID를 가져오세요. 장치가 복합 장치의 일부가 아니면 장치 ID와 루트 장치 ID가 동일합니다. GameInput v3 이하에서는 IGameInputDevice::GetDeviceInfo가 반환하는 GameInputDeviceInfo 구조체의 deviceId 멤버에서 이 정보를 얻을 수 있었습니다.

요구 사항

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

함께 보기

GameInput 개요
IGameInputDevice
IGameInputDevice::GetDeviceRootId
IGameInput::FindDeviceFromId
APP_LOCAL_DEVICE_ID

버전 기록

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