Skip to main content

IGameInput::CreateAggregateDevice

Crée une instance virtuelle de IGameInputDevice qui regroupe toutes les entrées du type GameInputKind spécifié.

Syntaxe

Paramètres

inputKind   _In_
Type : GameInputKind
Le type d’entrée pour lequel l’instance virtuelle de 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 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 au moyen du rappel inscrit par un appel à 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
IGameInput

Historique des versions

Last modified on October 6, 2026