Skip to main content

IGameInput::GetNextReading

Récupère la prochaine interface IGameInputReading disponible en fonction d’une lecture de référence provenant d’un flux d’entrée éventuellement filtré.

Syntaxe

Paramètres

referenceReading   _In_
Type : IGameInputReading*
L’interface 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 obtenir la lecture suivante. L’interface GameInputKind est une variable d’indicateurs. Vous pouvez combiner plusieurs valeurs pour filtrer selon plusieurs constantes GameInputKind. Lorsque plusieurs types d’entrée sont spécifiés, toutes les lectures qui contiennent au moins l’un de ces types d’entrée sont retenues et retournées. device   _In_opt_
Type : IGameInputDevice*
Filtre du périphérique précis à partir duquel obtenir la lecture suivante. reading   _COM_Outptr_
Type : IGameInputReading**
L’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éthodes GetNextReading et GetPreviousReading permettent aux applications de parcourir l’historique des entrées, une lecture à la fois. Retourne une valeur NULL et un HRESULT d’échec s’il n’y a 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, puisque 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 précis.

Configuration requise

En-tête : GameInput.h Vue d’ensemble de GameInput
IGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput

Historique des versions

Last modified on October 6, 2026