Skip to main content

IGameInput::GetCurrentReading

Recupera a leitura mais recente do fluxo de entrada que corresponde a um filtro fornecido pelo chamador.

Sintaxe

Parâmetros

inputKind   _In_
Tipo: GameInputKind
Um dos valores de enumeração que designa o tipo de dispositivo de entrada em uso, como um controle, teclado, mouse ou gamepad. Os valores de enumeração podem ser combinados para designar vários tipos de entrada. 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*
Um filtro opcional que retorna leituras de um dispositivo específico. reading   _COM_Outptr_
Tipo: IGameInputReading**
A leitura de entrada a ser retornada. Retorna NULL em caso de falha.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Essa função é usada para acessar inicialmente o fluxo de entrada. Você pode usar essa função com os métodos GetNextReading e GetPreviousReading para percorrer o fluxo de entrada sem perder entradas. Como alternativa, você pode continuar chamando GetCurrentReading para continuar obtendo a leitura mais atual, se o seu jogo puder tolerar a perda de algumas entradas. O exemplo de código a seguir demonstra como sondar o estado atual do gamepad.
O exemplo de código a seguir demonstra como sondar o estado atual do gamepad de um dispositivo específico.
O exemplo de código a seguir demonstra como sondar todos os estados do gamepad de um dispositivo específico.

Requisitos

Visão geral da API de entrada
IGameInput_GetNextReading
IGameInput_GetPreviousReading
IGameInput

Histórico de versões

Last modified on October 6, 2026