Versiones de XInput
XInput es una API multiplataforma que se ha enviado 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 del sistema operativo.
Hoy hay tres versiones actuales del archivo DLL XInput. Elija la versión adecuada de XInput en función de 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á pensada para ejecutarse en estas versiones de Windows y usas la funcionalidad XInput básica.
- XInput 1.3: XInput 1.3 se distribuye como un componente redistribuible en directX SDK con compatibilidad con Windows Vista, Windows 7 y Windows 8. Usa esta versión si la aplicación de escritorio está pensada para ejecutarse en estas versiones de Windows y necesitas 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. Está disponible "bandeja de entrada" 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 vincular estáticamente 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 y marcas de XINPUT_CAPS_NO_NAVIGATION y informes más precisos de XINPUT_CAPS_VOICE_SUPPORTED. Estas marcas se combinan en el miembro Flags de la estructura XINPUT_CAPABILITIES. La funciónXInputGetCapabilities devuelve XINPUT_CAPABILITIES.
XInput 9.1.0
Al igual que XInput 1.4, XInput 9.1.0 se distribuye hoy 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. Pero es conveniente usar para las aplicaciones que deben ejecutarse en versiones de nivel baja de Windows, pero no necesitan la funcionalidad de audio adicional proporcionada por XInput 1.4 o XInput 1.3.
Windows SDK contiene el encabezado y la biblioteca de importación para vincular estáticamente 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 XINPUT_CAPS_WIRELESS bit de funcionalidad incluso si un dispositivo inalámbrico está conectado.
- No se pueden determinar los auriculares de un identificador de usuario determinado. La funciónXInputGetAudioDeviceIds no está disponible y función XInputGetDSoundAudioDeviceGuids no devolverá ningún resultado en Windows 8.x o Windows 10.
- LasXInputEnable , XInputGetBatteryInformationy funciones 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 que se va a enviar en el SDK de DirectX era 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 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.).