Condividi tramite


Versioni di XInput

XInput è un'API multipiattaforma fornita per l'uso su Xbox e Windows. Su Xbox, XInput viene fornito come libreria statica compilata nel file eseguibile principale del gioco. In Windows, XInput viene fornito come DLL installata nelle cartelle di sistema del sistema operativo.

Attualmente sono disponibili tre versioni correnti della DLL XInput. Scegliere la versione appropriata di XInput in base alla funzionalità di XInput usata e alle versioni di Windows che si intende supportare.

  • XInput 1.4: XInput 1.4 viene fornito come parte di Windows 10. Usa questa versione per la compilazione di app UWP.
  • XInput 9.1.0: XInput 9.1.0 viene fornito come parte di Windows Vista, Windows 7 e Windows 8. Usa questa versione se l'app desktop è progettata per l'esecuzione in queste versioni di Windows e usi la funzionalità XInput di base.
  • XInput 1.3: XInput 1.3 viene fornito come componente ridistribuibile in DirectX SDK con supporto per Windows Vista, Windows 7 e Windows 8. Usa questa versione se l'app desktop è destinata all'esecuzione in queste versioni di Windows e hai bisogno di funzionalità non supportate da XInput 9.1.0.

XInput 1.4

XInput 1.4 viene fornito oggi come componente di sistema in Windows 8 come XINPUT1_4.DLL. È disponibile "posta in arrivo" e non richiede ridistribuzione con un'applicazione. Windows Software Development Kit (SDK) contiene l'intestazione e la libreria di importazione per il collegamento statico a XINPUT1_4.DLL. Per scaricare Windows 8 SDK, vedere Download per lo sviluppo di app desktop.

XInput 1.4 offre questi vantaggi principali rispetto ad altre versioni di XInput:

  • Questa è l'unica versione che può essere usata nelle app di Windows Store C++/DirectX.
  • La nuova funzione XInputGetAudioDeviceIds fornisce una stringa id dispositivo audio che è possibile usare per aprire una voce mastering XAudio2 o un dispositivo audio per un visore VR collegato a un controller. La funzione XInputGetDSoundAudioDeviceGuids non è disponibile in questa versione.
  • Offre funzionalità dei dispositivi migliorate, tra cui XINPUT_Cpiattaforma di strumenti analitici_WIRELESS, XINPUT_Cpiattaforma di strumenti analitici_FFB_SUPPORTED, XINPUT_Cpiattaforma di strumenti analitici_PMD_SUPPORTED e XINPUT_Cpiattaforma di strumenti analitici_NO_NAVIGATION flag e report più accurati di XINPUT_Cpiattaforma di strumenti analitici_VOICE_SUPPORTED. Questi flag vengono combinati nel membro Flags della struttura XINPUT_CAPABILITIES . La funzione XInputGetCapabilities restituisce XINPUT_CAPABILITIES.

XInput 9.1.0

Come XInput 1.4, XInput 9.1.0 viene fornito oggi come componente di sistema in Windows 10, Windows 8.x, Windows 7 e Windows Vista come XINPUT9_1_0.DLL. Viene gestito principalmente per garantire la compatibilità con le versioni precedenti con le applicazioni esistenti. Ha un set di funzioni ridotto, quindi è consigliabile usare XInput 1.4, se possibile. Ma è utile usare per le applicazioni che devono essere eseguite in versioni di livello inferiore di Windows, ma non richiedono le funzionalità audio aggiuntive fornite da XInput 1.4 o XInput 1.3.

Windows SDK contiene l'intestazione e la libreria di importazione per il collegamento statico a XINPUT9_1_0.DLL.

XInput 9.1.0 presenta questi svantaggi rispetto ad altre versioni di XInput:

XInput 1.3

Alcune versioni precedenti di XInput sono state fornite come DLL ridistribuibili in DirectX SDK. La prima versione ridistribuibile di XInput, XInput 1.1, fornita nella versione di aprile 2006 di DirectX SDK. L'ultima versione da distribuire in DirectX SDK era XInput 1.3, disponibile nella versione di giugno 2010 dell'SDK DirectX legacy. DirectX SDK non è più disponibile nei download Microsoft.

È possibile usare XInput 1.3 per le applicazioni che supportano le versioni di livello inferiore di Windows e richiedono funzionalità non fornite da XInput 9.1.0 (ovvero la segnalazione del sottotipo corretta, il supporto audio, il supporto esplicito per la segnalazione della batteria e così via).