Partager via

XInput Versions

  • Article

XInput est une API multiplateforme fournie pour une utilisation sur Xbox et Windows. Sur Xbox, XInput est fourni en tant que bibliothèque statique compilée dans l’exécutable principal du jeu. Sur Windows, XInput est fourni en tant que DLL installée dans les dossiers système du système d’exploitation.

Il existe trois versions actuelles de la DLL XInput aujourd’hui. Choisissez la version appropriée de XInput en fonction des fonctionnalités de XInput que vous utilisez et des versions de Windows que vous envisagez de prendre en charge.

  • XInput 1.4 : XInput 1.4 est fourni dans le cadre de Windows 10. Utilisez cette version pour créer des applications UWP.
  • XInput 9.1.0 : XInput 9.1.0 est fourni dans le cadre de Windows Vista, Windows 7 et Windows 8. Utilisez cette version si votre application de bureau est destinée à s’exécuter sur ces versions de Windows et que vous utilisez des fonctionnalités XInput de base.
  • XInput 1.3 : XInput 1.3 est fourni en tant que composant redistribuable dans le Kit de développement logiciel (SDK) DirectX avec prise en charge de Windows Vista, Windows 7 et Windows 8. Utilisez cette version si votre application de bureau est destinée à s’exécuter sur ces versions de Windows et si vous avez besoin de fonctionnalités qui ne sont pas prises en charge par XInput 9.1.0.

XInput 1.4

XInput 1.4 est fourni aujourd’hui en tant que composant système dans Windows 8 en tant que XINPUT1_4.DLL. Il est disponible « boîte de réception » et ne nécessite pas de redistribution avec une application. Le Kit de développement logiciel (SDK) Windows contient l’en-tête et la bibliothèque d’importation pour la liaison statique par rapport à XINPUT1_4.DLL. Pour télécharger le Kit de développement logiciel (SDK) Windows 8, consultez Téléchargements pour le développement d’applications de bureau.

XInput 1.4 présente ces principaux avantages par rapport aux autres versions de XInput :

  • Il s’agit de la seule version qui peut être utilisée dans les applications du Windows Store C++/DirectX.
  • La nouvelle fonction XInputGetAudioDeviceIds fournit une chaîne d’ID d’appareil audio que vous pouvez utiliser pour ouvrir un périphérique vocal ou audio de mastering XAudio2 pour un casque attaché à un contrôleur. La fonction XInputGetDSoundAudioDeviceGuids n’est pas disponible dans cette version.
  • Fournit des rapports de fonctionnalités d’appareil améliorées, notamment des indicateurs de XINPUT_CAPS_WIRELESS, de XINPUT_CAPS_FFB_SUPPORTED, de XINPUT_CAPS_PMD_SUPPORTED et de XINPUT_CAPS_NO_NAVIGATION et des rapports plus précis de XINPUT_CAPS_VOICE_SUPPORTED. Ces indicateurs sont combinés dans les indicateurs de membre de la structure XINPUT_CAPABILITIES. La fonction XInputGetCapabilities retourne XINPUT_CAPABILITIES.

XInput 9.1.0

Comme XInput 1.4, XInput 9.1.0 est fourni aujourd’hui en tant que composant système dans Windows 10, Windows 8.x, Windows 7 et Windows Vista comme XINPUT9_1_0.DLL. Il est géré principalement pour la compatibilité descendante avec les applications existantes. Il a un jeu de fonctions réduit. Nous vous recommandons donc d’utiliser XInput 1.4, si possible. Mais il est pratique d’utiliser pour les applications qui doivent s’exécuter sur des versions de bas niveau de Windows, mais n’ont pas besoin des fonctionnalités audio supplémentaires fournies par XInput 1.4 ou XInput 1.3.

Le Kit de développement logiciel (SDK) Windows contient l’en-tête et la bibliothèque d’importation pour la liaison statique par rapport à XINPUT9_1_0.DLL.

XInput 9.1.0 présente ces inconvénients par rapport aux autres versions de XInput :

  • Pour des raisons de compatibilité descendante, XInputGetCapabilities dans cette version de XInput retourne des informations de capacité fixe. Quel que soit l’appareil du contrôleur attaché, XInputGetCapabilities dans XInput 9.1.0 signale toujours un sous-type d’appareil de GAMEPAD. Il ne retourne pas le bit de capacité XINPUT_CAPS_WIRELESS même si un appareil sans fil est connecté.
  • Vous ne pouvez pas déterminer le casque pour un ID d’utilisateur donné. La fonctionXInputGetAudioDeviceIds n’est pas disponible et fonction XInputGetDSoundAudioDeviceGuids ne renvoie aucun résultat sur Windows 8.x ou Windows 10.
  • LesXInputEnable, XInputGetBatteryInformationet fonctions XInputGetKeystroke ne sont pas disponibles.

XInput 1.3

Certaines versions précédentes de XInput ont été fournies en tant que DLL redistribuables dans le Kit de développement logiciel (SDK) DirectX. La première version redistribuable de XInput, XInput 1.1, fournie dans la version d’avril 2006 du Kit de développement logiciel (SDK) DirectX. La dernière version à expédier dans le Kit de développement logiciel (SDK) DirectX était XInput 1.3, disponible dans la version de juin 2010 du SDK DirectX hérité. Le Kit de développement logiciel (SDK) DirectX n’est plus disponible sur les téléchargements Microsoft.

Vous pouvez utiliser XInput 1.3 pour les applications qui prennent en charge les versions de bas niveau de Windows et nécessitent des fonctionnalités non fournies par XInput 9.1.0 (autrement dit, la création de rapports de sous-type correcte, la prise en charge audio, la prise en charge explicite des rapports de batterie, etc.).