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

Crée une instance virtuelle de [IGameInputDevice](/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) qui regroupe toutes les entrées du type [GameInputKind](/fr-CA/reference/input/gameinput/enums/gameinputkind) spécifié.

## Syntaxe

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

### Paramètres

*inputKind*   \_In\_\
Type : [GameInputKind](/fr-CA/reference/input/gameinput/enums/gameinputkind)

Le type d'entrée pour lequel l'instance virtuelle de [IGameInputDevice](/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) retournée regroupera les lectures.

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

L'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](/fr-CA/reference/input/gameinput/enums/gameinputkind) non pris en charge est utilisé ou lors d'une tentative de combinaison d'indicateurs [GameInputKind](/fr-CA/reference/input/gameinput/enums/gameinputkind).

## Remarques

Le type d'entrée utilisé pour CreateAggregateDevice doit être une valeur unique de l'énumération [GameInputKind](/fr-CA/reference/input/gameinput/enums/gameinputkind). La combinaison d'indicateurs [GameInputKind](/fr-CA/reference/input/gameinput/enums/gameinputkind) 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](/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 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](/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice). Elle entraîne la réactivation du périphérique plutôt que la création d'une autre instance.</Note>

Le périphérique agrégé émet également des notifications d'état au moyen du rappel inscrit par un appel à [RegisterDeviceCallback](/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback).

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

## 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::CreateAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)
- [IGameInput::DisableAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md)
- [IGameInputDevice::CreateRawDeviceReport](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createrawdevicereport.md)
- [IGameInput::CreateDispatcher](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)