> ## 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.

# IGameInputDevice::GetDeviceId

> Obtiene el identificador local de la aplicación que identifica de forma única el dispositivo de entrada.

Obtiene el identificador local de la aplicación que identifica de forma única el dispositivo de entrada.

## Sintaxis

```cpp theme={null}
void GetDeviceId(
    APP_LOCAL_DEVICE_ID* deviceId
);
```

### Parámetros

*deviceId*   \_Out\_\
Tipo: [APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md)\*

Recibe el identificador local de la aplicación del dispositivo.

### Valor devuelto

Tipo: void

## Comentarios

El identificador del dispositivo es un identificador local de la aplicación: un valor hash de 256 bits que identifica de forma única el dispositivo. Este identificador permanece igual para un dispositivo determinado, incluso entre ejecuciones de una aplicación o reinicios del sistema, siempre que el dispositivo se conecte al mismo puerto USB. El hash se genera en parte a partir de información específica de la aplicación que llama y del sistema, por lo que el mismo dispositivo tiene identificadores diferentes en aplicaciones diferentes.

Como el identificador es estable, puede almacenarlo para recordar un dispositivo, como el mando preferido de un usuario, y buscar más adelante el objeto de dispositivo correspondiente llamando a [IGameInput::FindDeviceFromId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md).

Para los dispositivos que son una de varias interfaces de un dispositivo compuesto, use [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md) para obtener el identificador del dispositivo raíz. Si el dispositivo no forma parte de un dispositivo compuesto, el identificador del dispositivo y el identificador del dispositivo raíz son iguales.

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `deviceId` de la estructura [GameInputDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) devuelta por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)\
[IGameInput::FindDeviceFromId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)\
[APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md)

## Historial de versiones

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


## Related topics

- [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)
- [IGameInputDevice::IsConnected](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)
- [Usuarios y dispositivos de entrada](https://docs.xbox.com/es/build/core-features/common/user/users-input-devices.md)
- [IGameInputDevice::GetContainerId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.md)
- [IGameInputDevice::GetVendorId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md)