> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInput::FindDeviceFromId

> IGameInput::FindDeviceFromId

# IGameInput::FindDeviceFromId

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

## 구문

```cpp theme={null}
HRESULT FindDeviceFromId(
    const APP_LOCAL_DEVICE_ID* value,
    IGameInputDevice** device
);
```

### 매개변수

*value*   \_In\_\
형식: APP\_LOCAL\_DEVICE\_ID\*

장치에 대해 시스템에서 생성된 ID입니다.

*device*   \_COM\_Outptr\_\
형식: IGameInputDevice\*\*

반환된 장치입니다.

### 반환값

형식: HRESULT

함수 결과.

## 설명

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

## 요구 사항

**헤더:** GameInput.h

[Input API 개요](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)\
[IGameInput::GetCurrentReading](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading)\
[IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback)

## 버전 기록

| 버전     | 변경 사항 |
| ------ | ----- |
| **v0** | 도입됨.  |


## Related topics

- [IGameInput::FindDeviceFromObject](/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromPlatformHandle](/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)
- [APP_LOCAL_DEVICE_ID](/ko/reference/system/xuser/structs/app_local_device_id.md)
- [IGameInput::FindDeviceFromPlatformString](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring.md)
- [IGameInput::CreateAggregateDevice](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)