Skip to main content

IGameInput::GetPreviousReading

Récupère la lecture IGameInputReading précédente en fonction d’une lecture de référence, à partir d’un flux d’entrée éventuellement filtré.

Syntaxe

Paramètres

referenceReading   _In_
Type : IGameInputReading*
L’interface IGameInputReading retournée est lue séquentiellement avant cette lecture de référence. inputKind   _In_
Type : GameInputKind
Filtre pour les types d’entrée à partir desquels obtenir la lecture précédente. L’interface GameInputKind est une variable d’indicateurs. Vous pouvez combiner plusieurs valeurs pour filtrer sur plusieurs constantes. Lorsque plusieurs types d’entrée sont spécifiés, toutes les lectures qui contiennent au moins un des types d’entrée seront mises en correspondance et retournées. device   _In_opt_
Type : IGameInputDevice*
Filtre pour l’appareil spécifique à partir duquel obtenir la lecture précédente. reading   _COM_Outptr_
Type : IGameInputReading**
L’interface IGameInputReading retournée, qui vient séquentiellement avant 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, lecture par lecture. Retourne une valeur NULL et un HRESULT d’échec s’il n’y a aucune lecture après referenceReading, si un filtre d’appareil est fourni pour un appareil 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 appareil dans sa mémoire tampon d’historique. L’exemple de code suivant montre comment interroger tous les états de manette provenant d’un appareil spécifique.

Configuration requise

GameInput
Vue d’ensemble de GameInput
IGameInput_GetCurrentReading
IGameInput_GetNextReading
IGameInput

Historique des versions

Last modified on October 6, 2026