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

> IGameInput::CreateAggregateDevice

# IGameInput::CreateAggregateDevice

Crea una instancia virtual de [IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) que agrega toda la entrada del tipo [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md) especificado.

## Sintaxis

```cpp theme={null}
HRESULT CreateAggregateDevice(
         GameInputKind inputKind,
         APP_LOCAL_DEVICE_ID* deviceId
)
```

### Parámetros

*inputKind*   \_In\_\\
Tipo: [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md)

El tipo de entrada para el que la instancia virtual de [IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) devuelta agregará lecturas.

*deviceId*   \_Out\_\\
Tipo: APP\_LOCAL\_DEVICE\_ID\*

El identificador de dispositivo resultante del dispositivo agregado.

### Valor devuelto

Tipo: HRESULT

Resultado de la función. Devuelve un error cuando se usa un valor de [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md) no compatible o cuando se intenta combinar marcas de [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md).

## Comentarios

El tipo de entrada usado para CreateAggregateDevice debe ser un único valor de la enumeración [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md). No se admite la combinación de marcas de [GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md). Si una aplicación necesita entrada agregada para varios tipos de entrada, debe crear una instancia virtual de [IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) para cada uno.

> [!NOTE]
>
> Esta función se usa para volver a habilitar un dispositivo agregado que pueda haberse deshabilitado mediante una llamada a [DisableAggregateDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md). El resultado es que se vuelve a habilitar el dispositivo en lugar de crearse otra instancia.

El dispositivo agregado también emitirá notificaciones de estado a través de la devolución de llamada registrada mediante una llamada a [RegisterDeviceCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md).

La agregación solo se admite para los tipos de entrada siguientes:

* GameInputKindKeyboard
* GameInputKindMouse
* GameInputKindArcadeStick
* GameInputKindFlightStick
* GameInputKindGamepad
* GameInputKindRacingWheel

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

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v3** | Se implementó (anteriormente E\_NOTIMPL en v0) y se volvió a introducir. La firma cambió: `IGameInputDevice**` se reemplazó por `APP_LOCAL_DEVICE_ID*`. |
| **v1** | Se quitó. |
| **v0** | Se introdujo sin implementar. |


## Related topics

- [IGameInput::CreateDispatcher](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInput::FindDeviceFromId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::FindDeviceFromPlatformString](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring.md)
- [IGameInput::FindDeviceFromObject (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)