Skip to main content

XInputEnable

Define o estado de relatório do XInput.

Sintaxe

Parâmetros

enable   _In_
Tipo: BOOL
Se enable for FALSE, o XInput enviará apenas dados neutros em resposta a XInputGetState: ou seja, todos os botões soltos, eixos centralizados e gatilhos em 0. As chamadas a XInputSetState serão registradas, mas não serão enviadas ao dispositivo. Enviar qualquer valor diferente de FALSE restaurará a funcionalidade de leitura e gravação ao normal.

Valor retornado

Tipo: void Nenhum.

Comentários

Essa função foi preterida e não deve ser escrita em nenhum código novo. XInputEnable adiciona sobrecarga a muitas chamadas do wrapper XInput. Você pode usar #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE para eliminar XInputEnable e a sobrecarga resultante. Para obter mais informações, consulte Portabilidade do XInput para o GameInput. Essa função deve ser chamada quando um aplicativo ganha ou perde o foco. Ao usar essa função, você não precisará alterar o loop de consulta do XInput no seu aplicativo, pois dados neutros sempre serão relatados se o XInput estiver desabilitado. Em um controle que dá suporte a efeitos de vibração:
  • Passar FALSE interromperá todos os efeitos de vibração em reprodução no momento. Nesse estado, as chamadas a XInputSetState serão registradas, mas não serão passadas ao dispositivo.
  • Passar TRUE passará a última solicitação de vibração (mesmo que seja 0) enviada a XInputSetState para o dispositivo.

Requisitos

Cabeçalho: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

Portar o XInput para o GameInput
XInputOnGameInput
XInputGetState
XInputSetState
Last modified on October 6, 2026