> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XInputEnable

> XInputEnable

# XInputEnable

Define o estado de relatório do XInput.

## Sintaxe

```cpp theme={null}
void XInputEnable(  
         BOOL enable  
)  
```

### Parâmetros

*enable*   \_In\_\
Tipo: BOOL

Se enable for **FALSE**, o XInput enviará apenas dados neutros em resposta a [XInputGetState](/pt-BR/reference/input/xinputongameinput/functions/xinputgetstate): ou seja, todos os botões soltos, eixos centralizados e gatilhos em 0. As chamadas a [XInputSetState](/pt-BR/reference/input/xinputongameinput/functions/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](/pt-BR/build/core-features/common/input/porting/input-porting-xinput#optimizingSection).

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](/pt-BR/reference/input/xinputongameinput/functions/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](/pt-BR/reference/input/xinputongameinput/functions/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](/pt-BR/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/pt-BR/reference/input/xinputongameinput/xinputongameinput_members)\
[XInputGetState](/pt-BR/reference/input/xinputongameinput/functions/xinputgetstate)\
[XInputSetState](/pt-BR/reference/input/xinputongameinput/functions/xinputsetstate)


## Related topics

- [XInputEnable](/reference/input/xinputongameinput/functions/xinputenable.md)
- [Porting from XInput to GameInput](/build/core-features/common/input/porting/input-porting-xinput.md)
- [XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members.md)
- [Portabilidad de XInput a GameInput](/es/build/core-features/common/input/porting/input-porting-xinput.md)