다음을 통해 공유

IGameInput::FindDeviceFromId

  • 아티클

장치의 DeviceID를 기준으로 장치를 검색합니다.

구문

HRESULT FindDeviceFromId(  
         const APP_LOCAL_DEVICE_ID* value,  
         IGameInputDevice** device  
)

매개 변수

value _In_
형식: APP_LOCAL_DEVICE_ID*

시스템이 장치에 대해 생성한 ID.

device _COM_Outptr_
형식: IGameInputDevice**

반환된 장치.

반환 값

형식: HRESULT

함수 결과입니다.

비고

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

요구 사항

헤더: GameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

입력 API 개요
IGameInput
IGameInputDevice
IGameInput::GetCurrentReading
IGameInput::RegisterReadingCallback