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

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 s'appuie 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 peu de temps avant de retourner, suffisamment peu pour qu'il soit généralement sûr de l'appeler depuis un thread d'interface utilisateur, mais pas depuis des contextes sensibles au temps tels qu'une boucle de jeu. Les appels suivants à cette fonction depuis le même processus ajoutent simplement une autre référence au singleton sous-jacent et retournent rapidement.

Étant donné qu'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. GameInput étant 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 vaut même pour les 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` (lors de la reprise de l'application) dépasse généralement les avantages liés à la libération d'une petite quantité de mémoire dans l'application.

## Configuration requise

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

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

## Historique des versions

| Version | Modifications |
| - | - |
| **v0** | Introduite. |

## Documentation conceptuelle

* [Notions de base de GameInput](/fr/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)