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

> IGameInput::CreateAggregateDevice

# IGameInput::CreateAggregateDevice

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

## Sintaxis

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

### Parámetros

*inputKind*   \_In\_\\
Tipo: [GameInputKind](/reference/input/gameinput/enums/gameinputkind)

El tipo de entrada para el que la instancia virtual de [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 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](/reference/input/gameinput/enums/gameinputkind) no compatible o cuando se intenta combinar marcas de [GameInputKind](/reference/input/gameinput/enums/gameinputkind).

## Comentarios

El tipo de entrada usado para CreateAggregateDevice debe ser un único valor de la enumeración [GameInputKind](/reference/input/gameinput/enums/gameinputkind). No se admite la combinación de marcas de [GameInputKind](/reference/input/gameinput/enums/gameinputkind). Si una aplicación necesita entrada agregada para varios tipos de entrada, debe crear una instancia virtual de [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 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](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice). El resultado es que se vuelve a habilitar el dispositivo en lugar de crearse otra instancia.</Note>

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

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](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)

## 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](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInput::FindDeviceFromObject](/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromId](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::FindDeviceFromPlatformHandle](/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)