Función XInputEnable (xinput.h)

Artículo
03/05/2024

Establece el estado de notificación de XInput.

Sintaxis

void XInputEnable(
  [in] BOOL enable
);

Parámetros

[in] enable

Si enable es FALSE, XInput solo enviará datos neutros en respuesta a XInputGetState (todos los botones hacia arriba, ejes centrados y desencadenadores en 0). Las llamadas XInputSetState se registrarán pero no se enviarán al dispositivo. El envío de cualquier valor distinto de FALSE restaurará la funcionalidad de lectura y escritura a la normalidad.

Valor devuelto

None

Observaciones

Esta función está pensada para llamarse cuando una aplicación obtiene o pierde el foco (por ejemplo, a través de WM_ACTIVATEAPP). Con esta función, no tendrá que cambiar el bucle de consulta XInput en la aplicación, ya que los datos neutros siempre se notificarán si XInput está deshabilitado.

En un controlador que admite efectos de vibración:

Si se pasa FALSE , se detendrá cualquier efecto de vibración que se esté reproduciendo actualmente. En este estado, las llamadas a XInputSetState se registrarán, pero no se pasarán al dispositivo.
Pasar TRUE pasará la última solicitud de vibración (incluso si es 0) enviada a XInputSetState al dispositivo.

Windows 10 o posterior:En desuso, ya que el sistema habilita o deshabilita automáticamente la entrada del controlador de juegos en función del foco de la ventana de la aplicación.