> ## 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::GetDeviceRootId

> Obtiene el identificador local de la aplicación del nodo de dispositivo raíz del dispositivo de entrada.

Obtiene el identificador local de la aplicación del nodo de dispositivo raíz del dispositivo de entrada.

## Sintaxis

```cpp theme={null}
void GetDeviceRootId(
    APP_LOCAL_DEVICE_ID* deviceRootId
);
```

### Parámetros

*deviceRootId*   \_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 nodo de dispositivo raíz.

### Valor devuelto

Tipo: void

## Comentarios

El identificador del dispositivo raíz es un identificador local de la aplicación que identifica el nodo de dispositivo raíz de los dispositivos compuestos. Esto permite a las aplicaciones razonar sobre la relación de los dispositivos individuales. Por ejemplo, algunos teclados para juegos eluden el límite heredado de USB de ocho pulsaciones de teclas simultáneas exponiéndose como un dispositivo compuesto con varios nodos de teclado. Estos nodos se combinan en el teclado del "sistema", por lo que esto suele ser transparente para el usuario. Pero al procesar la entrada por teclado con la API de GameInput, comprender esta relación ayuda a las aplicaciones a evitar suposiciones incorrectas (por ejemplo, que una pulsación de tecla siempre procede de un dispositivo específico) al asignar funciones a las pulsaciones de teclas.

Los dispositivos que notifican el mismo identificador de dispositivo raíz pertenecen al mismo dispositivo compuesto. Si el dispositivo no es una de varias interfaces de un dispositivo compuesto, el identificador del dispositivo raíz es el mismo que el identificador devuelto por [IGameInputDevice::GetDeviceId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md).

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `deviceRootId` 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::GetDeviceId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)\
[IGameInputDevice::GetContainerId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.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::GetDeviceId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)
- [IGameInputDevice::GetContainerId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.md)
- [IGameInputDevice (Contenido de la interfaz)](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputDevice::GetVendorId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md)
- [IGameInputDevice::GetProductId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getproductid.md)