Compartir a través de


Función XInputEnable (xinput.h)

Establece el estado de informes 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). 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

Ninguno

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:

  • Pasar FALSE detendrá los efectos de vibración que se están 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 juego en función del foco de la ventana de la aplicación.

Requisitos de la plataforma de

Windows 8 (XInput 1.4), SDK de DirectX (XInput 1.3)

Requisitos

Requisito Valor
de la plataforma de destino de Windows
encabezado de xinput.h
biblioteca de Xinput.lib
DLL de Xinput1_4.dll

Consulte también

XINPUT_GAMEPAD

XINPUT_STATE

funciones XInput

XInputGetState

XInputSetState