Condividi tramite

Versioni di XInput

  • Articolo

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à avanzate per la creazione di report dei dispositivi, tra cui XINPUT_CAPS_WIRELESS, XINPUT_CAPS_FFB_SUPPORTED, XINPUT_CAPS_PMD_SUPPORTED e flag di XINPUT_CAPS_NO_NAVIGATION e report più accurati di XINPUT_CAPS_VOICE_SUPPORTED. Questi flag vengono combinati nel membro flag della struttura XINPUT_CAPABILITIES. La funzioneXInputGetCapabilitiesrestituisce 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:

  • Per motivi di compatibilità con le versioni precedenti, XInputGetCapabilities in questa versione di XInput restituisce informazioni sulle funzionalità fisse. Indipendentemente dal dispositivo controller collegato, XInputGetCapabilities in XInput 9.1.0 segnala sempre un sottotipo di dispositivo di GAMEPAD. Non restituirà il bit della funzionalità di XINPUT_CAPS_WIRELESS anche se un dispositivo wireless è connesso.
  • Non è possibile determinare il visore VR per un ID utente specificato. La funzioneXInputGetAudioIdsnon è disponibile e funzione XInputGetDSoundAudioGuids non restituirà alcun risultato in Windows 8.x o Windows 10.
  • Le funzioniXInputEnableXInputEnable , XInputGetBatteryInformationeXInputGetKeystroke non sono disponibili.

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 in 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).