Função XInputEnable (xinput.h)

Artigo
03/13/2024

Define o estado de relatório de XInput.

Sintaxe

void XInputEnable(
  [in] BOOL enable
);

Parâmetros

[in] enable

Se enable for FALSE, XInput enviará apenas dados neutros em resposta a XInputGetState (todos os botões para cima, eixos centralizados e gatilhos em 0). As chamadas XInputSetState serão registradas, mas não enviadas para o dispositivo. O envio de qualquer valor diferente de FALSE restaurará a funcionalidade de leitura e gravação como normal.

Retornar valor

Nenhum

Comentários

Essa função deve ser chamada quando um aplicativo ganha ou perde o foco (como por meio de WM_ACTIVATEAPP). Usando essa função, você não precisará alterar o loop de consulta XInput em seu aplicativo, pois dados neutros sempre serão relatados se XInput estiver desabilitado.

Em um controlador que dá suporte a efeitos de vibração:

Passar FALSE interromperá qualquer efeito de vibração que está sendo reproduzido no momento. Nesse estado, as chamadas para XInputSetState serão registradas, mas não passadas para o dispositivo.
Passar TRUE passará a última solicitação de vibração (mesmo que seja 0) enviada para XInputSetState para o dispositivo.

Windows 10 ou posterior:Preterido, pois a entrada do controlador de jogo é habilitada/desabilitada automaticamente pelo sistema com base no foco da janela do aplicativo.