Fonction XInputEnable (xinput.h)

Article
03/05/2024

Définit l’état de création de rapports de XInput.

Syntaxe

void XInputEnable(
  [in] BOOL enable
);

Paramètres

[in] enable

Si activer a la valeur FALSE, XInput envoie uniquement des données neutres en réponse à XInputGetState (tous les boutons vers le haut, les axes centrés et les déclencheurs à 0). Les appels XInputSetState seront enregistrés mais pas envoyés à l’appareil. L’envoi d’une valeur autre que FALSE restaure la fonctionnalité de lecture et d’écriture à la normale.

Valeur de retour

None

Remarques

Cette fonction est destinée à être appelée lorsqu’une application gagne ou perd le focus (par exemple via WM_ACTIVATEAPP). À l’aide de cette fonction, vous n’aurez pas à modifier la boucle de requête XInput dans votre application, car des données neutres seront toujours signalées si XInput est désactivé.

Dans un contrôleur qui prend en charge les effets de vibration :

Le passage de FALSE arrêtera tous les effets de vibration en cours de lecture. Dans cet état, les appels à XInputSetState seront inscrits, mais pas passés à l’appareil.
Le passage de TRUE transmet la dernière demande de vibration (même si elle est 0) envoyée à XInputSetState à l’appareil.

Windows 10 ou version ultérieure :Déconseillé, car l’entrée du contrôleur de jeu est automatiquement activée/désactivée par le système en fonction du focus de la fenêtre d’application.