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

Cria uma instância virtual de [IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) que agrega todas as entradas do [GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md) especificado.

## Sintaxe

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

### Parâmetros

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

O tipo de entrada para o qual o [IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) virtual retornado agregará leituras.

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

O identificador de dispositivo resultante para o dispositivo agregado.

### Valor retornado

Tipo: HRESULT

Resultado da função. Uma falha é retornada quando um [GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md) sem suporte é usado ou ao tentar combinar sinalizadores de [GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md).

## Comentários

O tipo de entrada usado para CreateAggregateDevice deve ser um único valor da enumeração [GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md). Não há suporte para combinar sinalizadores de [GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md). Se um aplicativo precisar de entrada agregada para vários tipos de entrada, ele deverá criar uma instância virtual de [IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) para cada um.

> [!NOTE]
>
> Essa função é usada para reabilitar um dispositivo agregado que possa ter sido desabilitado chamando [DisableAggregateDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md). Ela faz com que o dispositivo seja reabilitado, em vez de criar outra instância.

O dispositivo agregado também emitirá notificações de status por meio do retorno de chamada registrado ao chamar [RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md).

A agregação tem suporte apenas para os seguintes tipos de entrada:

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

## Requisitos

**Cabeçalho:** GameInput.h

[Visão geral da API de entrada](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v3** | Implementado (anteriormente E\_NOTIMPL na v0) e reintroduzido. Assinatura alterada: `IGameInputDevice**` substituído por `APP_LOCAL_DEVICE_ID*`. |
| **v1** | Removido. |
| **v0** | Introduzido, mas não implementado. |


## Related topics

- [IGameInput::DisableAggregateDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md)
- [CreateRawDeviceReport](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createrawdevicereport.md)
- [IGameInput::CreateDispatcher](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInput::FindDeviceFromId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)