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