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 |