Funzione XInputEnable (xinput.h)

Articolo
03/05/2024

Imposta lo stato di report di XInput.

Sintassi

void XInputEnable(
  [in] BOOL enable
);

Parametri

[in] enable

Se enable è FALSE, XInput invierà solo dati neutrali in risposta a XInputGetState (tutti i pulsanti su, assi centrati e trigger a 0). Le chiamate XInputSetState verranno registrate ma non inviate al dispositivo. L'invio di qualsiasi valore diverso da FALSE ripristina la funzionalità di lettura e scrittura alla normale.

Valore restituito

nessuno

Osservazioni

Questa funzione deve essere chiamata quando un'applicazione ottiene o perde lo stato attivo (ad esempio tramite WM_ACTIVATEAPP). Usando questa funzione, non sarà necessario modificare il ciclo di query XInput nell'applicazione come dati neutrali verranno sempre segnalati se XInput è disabilitato.

In un controller che supporta gli effetti della vibrazione:

Il passaggio di FALSE arresterà eventuali effetti di vibrazione attualmente riprodotti. In questo stato, le chiamate a XInputSetState verranno registrate, ma non passate al dispositivo.
Il passaggio di TRUE passerà l'ultima richiesta di vibrazione (anche se è 0) inviata a XInputSetState al dispositivo.

Windows 10 o versioni successive:Deprecato, poiché l'input del controller di gioco viene abilitato/disabilitato automaticamente dal sistema in base allo stato attivo della finestra dell'applicazione.