Skip to main content

XInputEnable

Establece el estado de notificación de XInput.

Sintaxis

Parámetros

enable   _In_
Tipo: BOOL
Si enable es FALSE, XInput solo enviará datos neutros en respuesta a XInputGetState: es decir, todos los botones sin presionar, los ejes centrados y los gatillos a 0. Las llamadas a XInputSetState se registrarán, pero no se enviarán al dispositivo. Enviar cualquier valor distinto de FALSE restaurará la funcionalidad de lectura y escritura a la normalidad.

Valor devuelto

Tipo: void Ninguno.

Comentarios

Esta función está en desuso y no debe incluirse en ningún código nuevo. XInputEnable agrega sobrecarga a muchas llamadas del contenedor de XInput. Puede usar #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE para eliminar XInputEnable y la sobrecarga resultante. Para obtener más información, consulte Migración de XInput a GameInput. Esta función está pensada para llamarse cuando una aplicación obtiene o pierde el foco. Al usar esta función, no tendrá que cambiar el bucle de consulta de XInput de la aplicación, porque siempre se notificarán datos neutros si XInput está deshabilitado. En un mando que admita efectos de vibración:
  • Pasar FALSE detendrá cualquier efecto de vibración que se esté reproduciendo en ese momento. 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 (aunque sea 0) enviada a XInputSetState y al dispositivo.

Requisitos

Encabezado: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Migración de XInput a GameInput
XInputOnGameInput
XInputGetState
XInputSetState
Última modificación el 28 de agosto de 2026