GameInputCreate
Obtient une instance de l’interface IGameInput.Syntaxe
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 fonctionGameInputCreate 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éesVue d’ensemble de GameInput
GameInput