IGameInput::GetNextReading
Recupera la siguiente interfaz IGameInputReading disponible a partir de una lectura de referencia de una secuencia de entrada filtrada opcionalmente.Sintaxis
Parámetros
referenceReading _In_\ Tipo: IGameInputReading* La interfaz IGameInputReading actual. La interfazIGameInputReading devuelta es la lectura siguiente a esta lectura de referencia.
inputKind _In_\
Tipo: GameInputKind
Filtro de los tipos de entrada de los que se extrae la lectura siguiente. La interfaz GameInputKind es una variable de marcas. Puede combinar varios valores para filtrar por varias constantes de GameInputKind. Cuando se especifican varios tipos de entrada, cualquier lectura que contenga al menos uno de los tipos de entrada coincidirá y se devolverá.
device _In_opt_\
Tipo: IGameInputDevice*
Filtro del dispositivo específico del que se extrae la lectura siguiente.
reading _COM_Outptr_\
Tipo: IGameInputReading**
La interfaz IGameInputReading devuelta que sigue secuencialmente a la entrada referenceReading.
Valor devuelto
Tipo: HRESULT Resultado de la función.Comentarios
Los métodosGetNextReading y GetPreviousReading permiten a las aplicaciones recorrer el historial de entrada lectura por lectura.
Devuelve un valor NULL y un HRESULT de error si no hay ninguna lectura después de referenceReading, si se proporciona un filtro de dispositivo para un dispositivo desconectado, o si ha transcurrido demasiado tiempo y la lectura de referencia y la lectura devuelta han salido del búfer de historial de la secuencia de entrada. El error por tiempo transcurrido es poco frecuente en las aplicaciones que procesan la entrada de forma continua, ya que la secuencia de entrada mantiene medio segundo de lecturas de cada dispositivo en su búfer de historial.
En el ejemplo de código siguiente se muestra cómo sondear todo el estado del mando desde un dispositivo específico.
Requisitos
Encabezado: GameInput.h Información general de GameInputIGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput
