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

Crée une instance virtuelle de [IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) qui agrège toutes les entrées du [GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md) spécifié.

## Syntaxe

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

### Paramètres

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

Type d'entrée pour lequel le [IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) virtuel retourné agrégera les lectures.

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

Identificateur de périphérique résultant pour le périphérique agrégé.

### Valeur de retour

Type : HRESULT

Résultat de la fonction. Un échec est retourné lorsqu'un [GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md) non pris en charge est utilisé ou lors d'une tentative de combinaison d'indicateurs [GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md).

## Remarques

Le type d'entrée utilisé pour CreateAggregateDevice doit être une valeur unique de l'énumération [GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md). La combinaison d'indicateurs [GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md) n'est pas prise en charge. Si une application a besoin d'entrées agrégées pour plusieurs types d'entrée, elle doit créer une instance virtuelle de [IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md) pour chacun d'eux.

> [!NOTE]
>
> Cette fonction sert à réactiver un périphérique agrégé qui a pu être désactivé par un appel à [DisableAggregateDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md). Elle entraîne la réactivation du périphérique plutôt que la création d'une autre instance.

Le périphérique agrégé émet également des notifications d'état via le rappel inscrit en appelant [RegisterDeviceCallback](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md).

L'agrégation est prise en charge uniquement pour les types d'entrée suivants :

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

## Configuration requise

**En-tête :** GameInput.h

[Vue d'ensemble de l'API d'entrée](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v3** | Implémentée (auparavant E\_NOTIMPL dans v0) et réintroduite. Signature modifiée : `IGameInputDevice**` remplacé par `APP_LOCAL_DEVICE_ID*`. |
| **v1** | Supprimée. |
| **v0** | Introduite, mais non implémentée. |


## Related topics

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