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

# GameInputCreate

> GameInputCreate

# GameInputCreate

Obtient une instance de l'interface IGameInput.

## Syntaxe

```cpp theme={null}
HRESULT GameInputCreate(
    IGameInput** gameInput
);
```

### Paramètres

*gameInput*   \_COM\_Outptr\_\
Type : IGameInput\*\*

Une instance du singleton sous-jacent par processus retournée par l'appel.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

La fonction `GameInputCreate` est une fabrique Nano-COM permettant d'obtenir ou de créer des instances de GameInput. L'interface résultante repose sur un singleton par processus qui est créé lors du premier appel de cette fonction. Par conséquent, le premier appel à cette fonction peut prendre un court moment avant de retourner — suffisamment court pour qu'il soit généralement sûr de l'appeler à partir d'un thread d'interface utilisateur, mais pas à partir de contextes sensibles au temps comme une boucle de jeu. Les appels subséquents à cette fonction à partir du même processus ne font qu'ajouter une autre référence au singleton sous-jacent et retournent rapidement.

Comme une seule version de GameInput est disponible à la fois sur le système, l'ensemble des interfaces prises en charge peut varier selon la version de GameInput installée. Comme GameInput est rétrocompatible, les nouvelles versions continueront de prendre en charge les anciennes interfaces même lorsque de nouvelles fonctionnalités sont ajoutées.

Les applications doivent appeler la fonction `GameInputCreate` une seule fois au démarrage et conserver la référence à l'objet `IGameInput` jusqu'à ce que l'application soit prête à s'arrêter. Cela s'applique même aux applications de la plateforme Windows universelle (UWP) qui répondent aux événements de suspension de la gestion de la durée de vie des processus (PLM), car le coût de réinitialisation du singleton `GameInput` (lorsque l'application reprend) dépasse généralement les avantages de libérer une petite quantité de mémoire dans l'application.

## Configuration requise

**En-tête :** GameInput.h

[Rubriques avancées sur GameInput](/fr-CA/build/core-features/common/input/advanced/input-advanced-topics)\
[Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview)\
[GameInput](/fr-CA/reference/input/gameinput/gameinput_members)

## Historique des versions

| Version | Modifications |
| - | - |
| **v0** | Introduit. |

## Documentation conceptuelle

* [Notions de base de GameInput](/fr-CA/build/core-features/common/input/overviews/input-fundamentals)


## Related topics

- [GameInputCreate](/reference/input/gameinput/functions/gameinputcreate.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [GameInput frequently asked questions](/build/core-features/common/input/overviews/input-faq.md)
- [Preguntas más frecuentes sobre GameInput](/es/build/core-features/common/input/overviews/input-faq.md)
- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)