Fonction XInputEnable (xinput.h)

Article
07/16/2024

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

Syntaxe

void XInputEnable(
  [in] BOOL enable
);

Paramètres

[in] enable

Si l’activation est 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). appels XInputSetState seront inscrits, mais pas envoyés à l’appareil. L’envoi d’une valeur autre que FALSE restaure la lecture et l’écriture des fonctionnalités normales.

Valeur de retour

Aucun

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 les données neutres seront toujours signalées si XInput est désactivé.

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

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

Windows 10 ou version ultérieure :déconseillée, 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.