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

# IGameInput::FindDeviceFromId

> IGameInput::FindDeviceFromId

# IGameInput::FindDeviceFromId

Recupera un dispositivo en función de su identificador.

## Sintaxis

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

### Parámetros

*value*   \_In\_\\
Tipo: APP\_LOCAL\_DEVICE\_ID\*

Identificador generado por el sistema para el dispositivo.

*device*   \_COM\_Outptr\_\\
Tipo: IGameInputDevice\*\*

El dispositivo devuelto.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

Una vez obtenida, la instancia de [IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) puede usarse como filtro en las API de sondeo como [IGameInput::GetCurrentReading](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading.md), o en las API basadas en eventos como [IGameInput::RegisterReadingCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md) (para recuperar la entrada), o usarse directamente para acceder a información y características específicas del dispositivo. Si el identificador proporcionado no coincide con ningún objeto de dispositivo de GameInput conocido, los métodos GetDeviceFrom\* devuelven un puntero `NULL`. Estos métodos consultan el estado local dentro del proceso que realiza la llamada y se devuelven rápidamente, por lo que es seguro llamarlos desde contextos con limitaciones de tiempo.

## Requisitos

**Encabezado:** GameInput.h

[Información general de la API de entrada](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInput::GetCurrentReading](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading.md)\
[IGameInput::RegisterReadingCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v0** | Se introdujo. |


## Related topics

- [IGameInput::FindDeviceFromObject (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromPlatformHandle (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md)
- [IGameInput::FindDeviceFromPlatformString](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring.md)
- [IGameInput::CreateAggregateDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)
