Skip to main content

IGameInput::CreateAggregateDevice

Crée une instance virtuelle de IGameInputDevice qui agrège toutes les entrées du GameInputKind spécifié.

Syntaxe

Paramètres

inputKind   _In_
Type : GameInputKind
Type d’entrée pour lequel le IGameInputDevice 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 non pris en charge est utilisé ou lors d’une tentative de combinaison d’indicateurs GameInputKind.

Remarques

Le type d’entrée utilisé pour CreateAggregateDevice doit être une valeur unique de l’énumération GameInputKind. La combinaison d’indicateurs 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 pour chacun d’eux.
Cette fonction sert à réactiver un périphérique agrégé qui a pu être désactivé par un appel à DisableAggregateDevice. 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. 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
IGameInput

Historique des versions

Last modified on October 6, 2026