Versiones de XInput

XInput es una API multiplataforma que se ha comenzado a distribuir para su uso en Xbox y Windows. En Xbox, XInput se distribuye como una biblioteca estática que se compila en el ejecutable principal del juego. En Windows, XInput se proporciona como un archivo DLL que se instala en las carpetas del sistema operativo.

Actualmente hay tres versiones del archivo DLL XInput. Elija la versión adecuada de XInput según la funcionalidad de XInput que use y las versiones de Windows que quiera admitir.

• XInput 1.4: XInput 1.4 se distribuye como parte de Windows 10. Usa esta versión para compilar aplicaciones para UWP.
• XInput 9.1.0: XInput 9.1.0 se distribuye como parte de Windows Vista, Windows 7 y Windows 8. Usa esta versión si la aplicación de escritorio está diseñada para ejecutarse en estas versiones de Windows, y si usted usa la funcionalidad XInput básica.
• XInput 1.3: XInput 1.3 se distribuye como un componente redistribuible en el SDK de DirectX con compatibilidad con Windows Vista, Windows 7 y Windows 8. Usa esta versión si la aplicación de escritorio está diseñada para ejecutarse en estas versiones de Windows y necesita funcionalidad no compatible con XInput 9.1.0.

XInput 1.4

XInput 1.4 se distribuye hoy como componente del sistema en Windows 8 como XINPUT1_4.DLL. Es una "bandeja de entrada" disponible y no requiere redistribución con una aplicación. El Kit de desarrollo de software (SDK) de Windows contiene el encabezado y la biblioteca de importación para la vinculación estática con XINPUT1_4.DLL. Para descargar el SDK de Windows 8, consulte Descargas para desarrollar aplicaciones de escritorio.

XInput 1.4 tiene estas principales ventajas sobre otras versiones de XInput:

• Esta es la única versión que se puede usar en aplicaciones de la Tienda Windows de C++/DirectX.
• La nueva función XInputGetAudioDeviceIds proporciona una cadena de identificador de dispositivo de audio que puede usar para abrir un dispositivo de audio o voz de maestro XAudio2 para un casco conectado a un controlador. La función XInputGetDSoundAudioDeviceGuids no está disponible en esta versión.
• Proporciona funcionalidades de dispositivo mejoradas que incluyen informes de XINPUT_CAPS_WIRELESS, XINPUT_CAPS_FFB_SUPPORTED, XINPUT_CAPS_PMD_SUPPORTED, marcas de XINPUT_CAPS_NO_NAVIGATION e informes más precisos de XINPUT_CAPS_VOICE_SUPPORTED. Estas marcas se combinan en el miembro Marcas de la estructura XINPUT_CAPABILITIES. La función XInputGetCapabilities devuelve XINPUT_CAPABILITIES.

XInput 9.1.0

Al igual que XInput 1.4, XInput 9.1.0 se distribuye actualmente como componente del sistema en Windows 10, Windows 8.x, Windows 7 y Windows Vista como XINPUT9_1_0.DLL. Se mantiene principalmente por motivos de compatibilidad con versiones anteriores con las aplicaciones existentes. Tiene un conjunto de funciones reducido, por lo que se recomienda usar XInput 1.4, si es posible. Sin embargo, su uso es conveniente para las aplicaciones que deben ejecutarse en versiones de nivel bajo de Windows, pero que no necesitan la funcionalidad de audio adicional proporcionada por XInput 1.4 o XInput 1.3.

Microsoft Windows SDK contiene el encabezado y la biblioteca de importación para su vinculación estática con XINPUT9_1_0.DLL.

XInput 9.1.0 tiene estas desventajas respecto a otras versiones de XInput:

• Por motivos de compatibilidad con versiones anteriores, XInputGetCapabilities en esta versión de XInput devuelve información de funcionalidad fija. Independientemente del dispositivo del controlador conectado, XInputGetCapabilities en XInput 9.1.0 siempre notificará un subtipo de dispositivo de GAMEPAD. No devolverá el bit de funcionalidad de XINPUT_CAPS_WIRELESS, incluso si un dispositivo inalámbrico está conectado.
• No se pueden determinar los auriculares de un identificador de usuario determinado. La función XInputGetAudioDeviceIds no está disponible y la función XInputGetDSoundAudioDeviceGuids no devolverá ningún resultado en Windows 8.x o Windows 10.
• Las funciones XInputEnable, XInputGetBatteryInformation y XInputGetKeystroke no están disponibles.

XInput 1.3

Algunas versiones anteriores de XInput se han proporcionado como archivos DLL redistribuibles en el SDK de DirectX. La primera versión redistribuible de XInput, XInput 1.1, enviada en la versión de abril de 2006 del SDK de DirectX. La última versión por distribuir en el SDK de DirectX fue XInput 1.3, disponible en la versión de junio de 2010 del SDK de DirectX heredado. El SDK de DirectX ya no está disponible en las descargas de Microsoft.

Puede usar XInput 1.3 para las aplicaciones que admiten versiones de nivel descendente de Windows y requieren funcionalidad no proporcionada por XInput 9.1.0 (es decir, informes de subtipo correctos, compatibilidad con audio, compatibilidad explícita con informes de batería, etc.).