> ## 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\*

系統為裝置產生的識別碼。

*device*   \_COM\_Outptr\_\
類型：IGameInputDevice\*\*

傳回的裝置。

### 傳回值

類型：HRESULT

函式結果。

## 備註

取得之後，[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 執行個體可以在輪詢 API (例如 [IGameInput::GetCurrentReading](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading)) 或事件型 API (例如 [IGameInput::RegisterReadingCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback)) 中作為篩選條件使用 (以擷取輸入)，或直接用來存取裝置特定的資訊和功能。如果提供的識別碼無法與任何已知的 GameInput 裝置物件相符，GetDeviceFrom\* 方法會傳回 `NULL` 指標。這些方法會查詢呼叫處理序內的本機狀態並很快傳回，因此可以安全地從時間敏感的內容中呼叫。

## 需求

**標頭：** GameInput.h

[輸入 API 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)\
[IGameInput::GetCurrentReading](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading)\
[IGameInput::RegisterReadingCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 已推出。 |


## Related topics

- [IGameInput::FindDeviceFromId](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::FindDeviceFromObject](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)