IGameInput

Singleton par processus utilisé pour accéder au flux d’entrée des périphériques. L’interface IGameInput est le point de départ de l’utilisation de l’API GameInput. Cette interface fournit des méthodes permettant de récupérer de manière synchrone les lectures mises en cache à partir du flux d’entrée (l’API d’interrogation), ainsi que des méthodes permettant d’inscrire des rappels asynchrones pour les changements d’état (l’API basée sur les événements).

Syntaxe

class IGameInput : public IUnknown

Méthodes

Méthode	Description
CreateAggregateDevice	Crée un périphérique virtuel qui agrège toutes les entrées d’un type d’entrée.
DisableAggregateDevice	Désactive l’agrégation d’un périphérique agrégé.
CreateDispatcher	Crée un répartiteur pour les tâches en arrière-plan.
FindDeviceFromId	Récupère une interface IGameInputDevice à l’aide de son identificateur.
FindDeviceFromPlatformString	Récupère une interface IGameInputDevice à l’aide d’une chaîne de plateforme correspondante.
GetCurrentReading	Obtient la dernière lecture du flux d’entrée qui correspond à un filtre spécifié.
GetCurrentTimestamp	Obtient l’heure actuelle en microsecondes.
GetNextReading	Obtient la prochaine interface IGameInputReading disponible en fonction d’une lecture de référence issue d’un flux d’entrée éventuellement filtré.
GetPreviousReading	Obtient l’interface IGameInputReading précédente en fonction d’une lecture de référence issue d’un flux d’entrée éventuellement filtré.
RegisterDeviceCallback	Inscrit une fonction de rappel appelée lorsque l’état du périphérique change.
RegisterKeyboardLayoutCallback	Inscrit une fonction de rappel pour les changements de disposition du clavier.
RegisterReadingCallback	Inscrit une fonction de rappel appelée lorsqu’une nouvelle lecture est disponible.
RegisterSystemButtonCallback	Inscrit une fonction de rappel pour les événements d’appui et de relâchement du bouton Guide ou Partager.
SetFocusPolicy	Définit la stratégie de focus des périphériques d’entrée d’un jeu.
StopCallback	Arrête un rappel inscrit sans attendre la fin des rappels en cours d’exécution.
UnregisterCallback	Arrête un rappel inscrit en attendant la fin des rappels en cours d’exécution.

Configuration requise

En-tête : GameInput.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de l’API d’entrée
GameInput

Historique des versions

Version	Modifications
v3	Ajout de `CreateAggregateDevice` (auparavant E_NOTIMPL dans v0, absente dans v1/v2). Ajout de `DisableAggregateDevice`.
v1	Suppression de `CreateAggregateDevice`, `EnableOemDeviceSupport`, `FindDeviceFromObject`, `FindDeviceFromPlatformHandle`, `GetTemporalReading`, `RegisterGuideButtonCallback`.
v0	Introduite.

Annexe : versions précédentes

v0

En plus de toutes les méthodes présentes dans la version actuelle, les méthodes suivantes existaient dans v0 et ont été supprimées dans v1 :

Méthode	Description
CreateAggregateDevice (E_NOTIMPL)	Présente, mais retournait `E_NOTIMPL`. Réintroduite de manière fonctionnelle dans v3.
EnableOemDeviceSupport	Activait la prise en charge des périphériques OEM utilisant des protocoles personnalisés. Cette prise en charge est désormais activée par défaut.
FindDeviceFromObject	Récupère un périphérique à partir d’une référence d’objet COM de plateforme.
FindDeviceFromPlatformHandle	Récupère un périphérique à partir d’un handle de fenêtre ou de fichier de plateforme.
GetTemporalReading	Obtient une lecture interpolée à un horodatage spécifié.
RegisterGuideButtonCallback	Inscrit un rappel pour les événements d’appui et de relâchement du bouton Guide/XBOX.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

IGameInput

IGameInput

Syntaxe

Méthodes

Configuration requise

Voir aussi

Historique des versions

Annexe : versions précédentes

v0

​IGameInput

​Syntaxe

​Méthodes

​Configuration requise

​Voir aussi

​Historique des versions

​Annexe : versions précédentes

​v0

IGameInput

Syntaxe

Méthodes

Configuration requise

Voir aussi

Historique des versions

Annexe : versions précédentes

v0