IGameInput::GetNextReading
Récupère la prochaine interface IGameInputReading disponible en fonction d’une lecture de référence issue d’un flux d’entrée éventuellement filtré.Syntaxe
Paramètres
referenceReading _In_Type : IGameInputReading* IGameInputReading actuelle. L’interface
IGameInputReading retournée est la lecture qui suit cette lecture de référence.
inputKind _In_Type : GameInputKind Filtre des types d’entrée à partir desquels extraire la lecture suivante. L’interface
GameInputKind est une variable d’indicateurs. Vous pouvez combiner plusieurs valeurs pour filtrer sur plusieurs constantes GameInputKind. Lorsque plusieurs types d’entrée sont spécifiés, toutes les lectures contenant au moins l’un de ces types d’entrée sont considérées comme correspondantes et retournées.
device _In_opt_Type : IGameInputDevice* Filtre du périphérique spécifique à partir duquel extraire la lecture suivante. reading _COM_Outptr_
Type : IGameInputReading** Interface
IGameInputReading retournée, qui suit séquentiellement l’entrée referenceReading.
Valeur de retour
Type : HRESULT Résultat de la fonction.Remarques
Les méthodesGetNextReading et GetPreviousReading permettent aux applications de parcourir l’historique des entrées lecture par lecture.
Retourne une valeur NULL et un HRESULT d’échec s’il n’existe aucune lecture après referenceReading, si un filtre de périphérique est fourni pour un périphérique déconnecté, ou si trop de temps s’est écoulé et que la lecture de référence et la lecture retournée ont quitté la mémoire tampon d’historique du flux d’entrée. L’erreur liée au temps écoulé est rare pour les applications qui traitent les entrées en continu, car le flux d’entrée conserve une demi-seconde de lectures de chaque périphérique dans sa mémoire tampon d’historique.
L’exemple de code suivant montre comment interroger tous les états de la manette de jeu à partir d’un périphérique spécifique.
Configuration requise
En-tête : GameInput.h Vue d’ensemble de GameInputIGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput
