Skip to main content

IGameInput::FindDeviceFromId

식별자를 기반으로 장치를 검색합니다.

구문

매개변수

value   _In_
형식: APP_LOCAL_DEVICE_ID*
장치에 대해 시스템에서 생성된 ID입니다. device   _COM_Outptr_
형식: IGameInputDevice**
반환된 장치입니다.

반환값

형식: HRESULT 함수 결과.

설명

일단 얻은 IGameInputDevice 인스턴스는 IGameInput::GetCurrentReading과 같은 폴링 API 또는 IGameInput::RegisterReadingCallback과 같은 이벤트 기반 API에서 필터로 사용되어 입력을 검색하거나, 장치별 정보 및 기능에 직접 접근하는 데 사용할 수 있습니다. 제공된 식별자가 알려진 GameInput 장치 개체와 일치하지 않는 경우, GetDeviceFrom* 메서드는 NULL 포인터를 반환합니다. 이 메서드들은 호출하는 프로세스 내의 로컬 상태를 조회하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

요구 사항

헤더: GameInput.h Input API 개요
IGameInput
IGameInputDevice
IGameInput::GetCurrentReading
IGameInput::RegisterReadingCallback

버전 기록

마지막 수정일 2026년 8월 13일