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

> IGameInput

# 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

```cpp theme={null}
class IGameInput : public IUnknown
```

## Méthodes

| Méthode | Description |
| - | - |
| [CreateAggregateDevice](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice) | Crée un périphérique virtuel qui agrège toutes les entrées d'un type d'entrée. |
| [DisableAggregateDevice](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice) | Désactive l'agrégation d'un périphérique agrégé. |
| [CreateDispatcher](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher) | Crée un répartiteur pour les tâches en arrière-plan. |
| [FindDeviceFromId](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid) | Récupère une interface IGameInputDevice à l'aide de son identificateur. |
| [FindDeviceFromPlatformString](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring) | Récupère une interface IGameInputDevice à l'aide d'une chaîne de plateforme correspondante. |
| [GetCurrentReading](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrentreading) | Obtient la dernière lecture du flux d'entrée qui correspond à un filtre spécifié. |
| [GetCurrentTimestamp](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrenttimestamp) | Obtient l'heure actuelle en microsecondes. |
| [GetNextReading](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_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](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_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](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) | Inscrit une fonction de rappel appelée lorsque l'état du périphérique change. |
| [RegisterKeyboardLayoutCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback) | Inscrit une fonction de rappel pour les changements de disposition du clavier. |
| [RegisterReadingCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback) | Inscrit une fonction de rappel appelée lorsqu'une nouvelle lecture est disponible. |
| [RegisterSystemButtonCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) | Inscrit une fonction de rappel pour les événements d'appui et de relâchement du bouton Guide ou Partager. |
| [SetFocusPolicy](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy) | Définit la stratégie de focus des périphériques d'entrée d'un jeu. |
| [StopCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback) | Arrête un rappel inscrit sans attendre la fin des rappels en cours d'exécution. |
| [UnregisterCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_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](/fr/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/fr/reference/input/gameinput/gameinput_members)

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


## Related topics

- [IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput.md)
- [IGameInput::StopCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::UnregisterCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::CreateDispatcher](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)