Função XInputEnable (xinput.h)
Define o estado de relatório de XInput.
Sintaxe
void XInputEnable(
[in] BOOL enable
);
Parâmetros
[in] enable
Se habilitar for FALSE, o XInput enviará apenas dados neutros em resposta a XInputGetState (todos os botões para cima, eixos centralizados e gatilhos em 0). XInputSetState chamadas serão registradas, mas não enviadas para o dispositivo. Enviar qualquer valor diferente de FALSE restaurará a funcionalidade de leitura e gravação ao normal.
Valor de retorno
Nenhum
Observações
Essa função deve ser chamada quando um aplicativo ganha ou perde o foco (como por 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á os efeitos de vibração que estão sendo reproduzidas 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.
Requisitos da plataforma
Windows 8 (XInput 1.4), SDK do DirectX (XInput 1.3)Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino |
Windows |
| cabeçalho | xinput.h |
| biblioteca | Xinput.lib |
| de DLL |
Xinput1_4.dll |