Skip to main content

IGameInput::GetNextReading

Recupera a próxima interface IGameInputReading disponível com base em uma leitura de referência de um fluxo de entrada opcionalmente filtrado.

Sintaxe

Parâmetros

referenceReading   _In_
Tipo: IGameInputReading*
A IGameInputReading atual. A interface IGameInputReading retornada é a próxima leitura após essa leitura de referência. inputKind   _In_
Tipo: GameInputKind
Filtro para os tipos de entrada dos quais obter a próxima leitura. A interface GameInputKind é uma variável de sinalizador. Você pode combinar vários valores para filtrar por várias constantes de GameInputKind. Quando vários tipos de entrada são especificados, todas as leituras que contêm pelo menos um dos tipos de entrada serão correspondidas e retornadas. device   _In_opt_
Tipo: IGameInputDevice*
Filtro para o dispositivo específico do qual obter a próxima leitura. reading   _COM_Outptr_
Tipo: IGameInputReading**
A interface IGameInputReading retornada que vem sequencialmente após a entrada referenceReading.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Os métodos GetNextReading e GetPreviousReading permitem que os aplicativos percorram o histórico de entrada, leitura por leitura. Retorna um valor NULL e um HRESULT de falha se não houver nenhuma leitura após a referenceReading, se um filtro de dispositivo for fornecido para um dispositivo desconectado ou se tiver decorrido tempo demais e a leitura de referência e a leitura retornada tiverem saído do buffer de histórico do fluxo de entrada. O erro de tempo decorrido é raro em aplicativos que processam a entrada continuamente, pois o fluxo de entrada mantém meio segundo de leituras de cada dispositivo em seu buffer de histórico. O exemplo de código a seguir demonstra como sondar todo o estado do gamepad de um dispositivo específico.

Requisitos

Cabeçalho: GameInput.h Visão geral do GameInput
IGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput

Histórico de versões

Last modified on October 6, 2026