GameInput. A funcionalidade do GameInput é um superconjunto de todas as APIs de entrada anteriores. Como resultado, portar de uma API de entrada anterior é, na maioria dos casos, um processo simples. As maiores mudanças geralmente decorrem do fato de o GameInput ser centrado na entrada, e não no dispositivo. O código que usa APIs anteriores normalmente enumera os dispositivos de entrada antes de ler sua entrada. No GameInput, no entanto, isso não é necessário. A adaptação ao modelo centrado na entrada do GameInput geralmente representa a maior parte das alterações estruturais no código anterior que será portado.
Os tópicos a seguir fornecem detalhes sobre as diferenças entre o GameInput e as APIs de entrada anteriores. Esses tópicos também incluem exemplos de código que destacam as maiores diferenças entre as APIs.
Portabilidade do Windows.Xbox.Input para o GameInput
Descreve a portabilidade do Windows.Xbox.Input no XBOX One Software Development Kit original.
Portabilidade do XInput para o GameInput
Descreve a portabilidade do XInput.
Uso do GameInput lado a lado com APIs mais antigas
Para aplicativos que desejam usar código do GameInput lado a lado com interfaces e APIs mais antigas, a API é flexível o suficiente para permitir também esse caso de uso. Isso permite que os aplicativos aproveitem facilmente novos recursos, como suporte a sensores e hápticos, sem substituir todas as suas pilhas de entrada. A partir da versão 1 (v1),GameInputDeviceInfo contém um campo pnppath que representa um caminho para o dispositivo subjacente. Esse campo é igual ao caminho em DIPROPGUIDANDPATH fornecido pelo DirectInput. Ele também pode ser usado pelos aplicativos para interagir diretamente com o dispositivo chamando CreateFile. Observe que dispositivos Game Input Protocol (GIP) que não são gamepads podem não ter essa propriedade, pois não podem ser abertos diretamente.