HKLM\SOFTWARE\Microsoft\GameInputRedist. A API Windows.Gaming.Input (WGI) compartilha esses mapeamentos, com extensões adicionais para o GameInput. Para obter mais informações, consulte Dados de registro para controles de jogo. A GameInput Device Mapping Tool permite que os desenvolvedores de hardware gerem esses mapeamentos para seus dispositivos e os testem em tempo real.
Ao iniciar a ferramenta, você pode selecionar um dos seus acessórios de gamepad conectados. O GameInput enumera todos os dispositivos habilitados para XInput e os dispositivos HID com página de uso 0x0001 (Generic Desktop Controls) e uso 0x0005 (Game Pad) ou 0x0004 (Joystick). Quando você seleciona um dispositivo, a ferramenta exibe, por padrão, as leituras do GameInput e as informações do dispositivo resultantes.
Ao passar para o fluxo de configuração, você pode continuar a partir da configuração (se houver) disponível no momento no seu PC com Windows, de um arquivo de registro existente criado por esta ferramenta ou do zero. A ferramenta orienta você no processo de mapear os relatórios de entrada do seu dispositivo para as interfaces do GameInput, como gamepad, manche de voo, volante de corrida e controle de navegação da interface do usuário. Em seguida, você pode conciliar esses mapeamentos com os rótulos específicos do seu dispositivo ou usar como padrão os rótulos usados para dispositivos XInput. Você também pode adicionar suporte a recursos avançados, como háptica e giroscópio. Por fim, você pode testar os mapeamentos resultantes em tempo real antes de confirmar suas alterações.
A ferramenta pode exportar os mapeamentos como um arquivo. Em seguida, você pode enviar manualmente o arquivo à Microsoft para avaliação (use o link ‘Contact Owners’ na página do NuGet do GameInput), distribuí-lo com seu driver ou incluí-lo no pacote de instalação do seu aplicativo.
Ferramenta de mapeamento de dispositivos e guia de testes do GameInput
Ferramenta de mapeamento de dispositivos e guia de testes do GameInput
A GameInput Device Mapping Tool, que pode ser encontrada no projeto GameInput no GitHub, é um utilitário que os desenvolvedores de hardware usam para testar como a API GameInput reconhece e mapeia seus dispositivos. A ferramenta fornece uma interface visual para inspecionar os relatórios de entrada do dispositivo e as leituras do GameInput e as informações do dispositivo resultantes geradas pela API. Essas informações são especialmente úteis para depurar e validar o comportamento de novos dispositivos ou para entender como os dispositivos existentes são interpretados pelo GameInput.
Como os dispositivos HID genéricos podem ter várias interpretações possíveis pelos sistemas de destino, o GameInput depende de uma série de extensões de mapeamento de dispositivos incorporadas ao registro do Windows. Você pode encontrá-las em
Last modified on October 6, 2026