XInput Versões

XInput é uma API multiplataforma que foi enviada para uso no Xbox e Windows. No Xbox, o XInput é fornecido como uma biblioteca estática que é compilada no executável principal do jogo. No Windows, XInput é fornecido como uma DLL que é instalada nas pastas do sistema operacional.

Existem três versões atuais da DLL XInput hoje. Escolha a versão apropriada do XInput com base na funcionalidade do XInput que você usa e nas versões do Windows que você pretende suportar.

• XInput 1.4: XInput 1.4 é fornecido como parte do Windows 10. Use esta versão para criar aplicativos UWP.
• XInput 9.1.0: XInput 9.1.0 é fornecido como parte do Windows Vista, Windows 7 e Windows 8. Utilize esta versão se a sua aplicação de ambiente de trabalho se destinar a ser executada nestas versões do Windows e estiver a utilizar a funcionalidade XInput básica.
• XInput 1.3: O XInput 1.3 é fornecido como um componente redistribuível no SDK do DirectX com suporte para Windows Vista, Windows 7 e Windows 8. Utilize esta versão se a sua aplicação de ambiente de trabalho se destinar a ser executada nestas versões do Windows e necessitar de funcionalidades que não são suportadas pelo XInput 9.1.0.

XInput 1.4

XInput 1.4 é lançado hoje como um componente do sistema no Windows 8 como XINPUT1_4.DLL. Está disponível "caixa de entrada" e não requer redistribuição com um aplicativo. O Windows Software Development Kit (SDK) contém o cabeçalho e a biblioteca de importação para vinculação estática contra XINPUT1_4.DLL. Para transferir o SDK do Windows 8, consulte transferências para o desenvolvimento de aplicações de ambiente de trabalho.

XInput 1.4 tem estas vantagens principais sobre outras versões do XInput:

• Esta é a única versão que pode ser usada em aplicativos da Windows Store em C++/DirectX.
• A nova funçãoXInputGetAudioDeviceIds dofornece uma cadeia de caracteres de identificação de dispositivo de áudio que você pode usar para abrir um dispositivo de voz ou áudio de masterização XAudio2 para um fone de ouvido conectado a um controle. A funçãoXInputGetDSoundAudioDeviceGuids não está disponível nesta versão.
• Fornece relatórios de recursos aprimorados do dispositivo, incluindo XINPUT_CAPS_WIRELESS, XINPUT_CAPS_FFB_SUPPORTED, XINPUT_CAPS_PMD_SUPPORTED e sinalizadores de XINPUT_CAPS_NO_NAVIGATION e relatórios mais precisos de XINPUT_CAPS_VOICE_SUPPORTED. Estas bandeiras são combinadas no Flags membro da estrutura XINPUT_CAPABILITIES. A funçãoXInputGetCapabilities retorna XINPUT_CAPABILITIES.

XInput 9.1.0

Como o XInput 1.4, o XInput 9.1.0 é lançado hoje como um componente do sistema no Windows 10, Windows 8.x, Windows 7 e Windows Vista como XINPUT9_1_0.DLL. Ele é mantido principalmente para compatibilidade com versões anteriores com aplicativos existentes. Tem um conjunto de funções reduzido, por isso recomendamos que use XInput 1.4, se possível. Mas é conveniente usar para aplicativos que devem ser executados em versões de nível inferior do Windows, mas não precisam da funcionalidade de áudio adicional fornecida pelo XInput 1.4 ou XInput 1.3.

O SDK do Windows contém o cabeçalho e a biblioteca de importação para vinculação estática contra XINPUT9_1_0.DLL.

XInput 9.1.0 tem estas desvantagens sobre outras versões do XInput:

• Por motivos de compatibilidade com versões anteriores, XInputGetCapabilities nesta versão do XInput retorna informações de capacidade fixa. Independentemente do dispositivo controlador conectado, XInputGetCapabilities no XInput 9.1.0 sempre relatará um subtipo de dispositivo do GAMEPAD. Ele não retornará o bit de capacidade XINPUT_CAPS_WIRELESS, mesmo se um dispositivo sem fio estiver conectado.
• Não é possível determinar o fone de ouvido para um determinado ID de usuário. A funçãoXInputGetAudioDeviceIds não está disponível e função XInputGetDSoundAudioDeviceGuids não retornará resultados no Windows 8.x ou Windows 10.
• As funções XInputEnable, XInputGetBatteryInformatione XInputGetKeystroke não estão disponíveis.

XInput 1.3

Algumas versões anteriores do XInput foram fornecidas como DLLs redistribuíveis no SDK do DirectX. A primeira versão redistribuível do XInput, XInput 1.1, foi fornecida na versão de abril de 2006 do SDK do DirectX. A última versão a ser fornecida no SDK do DirectX foi o XInput 1.3, disponível na versão de junho de 2010 do SDK do DirectX herdado. O SDK do DirectX não está mais disponível no Microsoft Downloads.

Você pode usar o XInput 1.3 para aplicativos que oferecem suporte a versões de nível inferior do Windows e exigem funcionalidade não fornecida pelo XInput 9.1.0 (ou seja, relatórios de subtipos corretos, suporte de áudio, suporte explícito a relatórios de bateria e assim por diante).