Funzione XInputEnable (xinput.h)

Articolo
07/16/2024

Imposta lo stato di segnalazione di XInput.

Sintassi

void XInputEnable(
  [in] BOOL enable
);

Parametri

[in] enable

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

Valore restituito

Nessuno

Osservazioni

Questa funzione è destinata a 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 perché i dati neutrali verranno sempre segnalati se XInput è disabilitato.

In un controller che supporta gli effetti di vibrazione:

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

Windows 10 o versione successiva:deprecato, perché l'input del controller di gioco viene abilitato/disabilitato automaticamente dal sistema in base allo stato attivo della finestra dell'applicazione.