GameInput. Les fonctionnalités de GameInput constituent un sur-ensemble de toutes les API d’entrée précédentes. Par conséquent, le portage à partir d’une API d’entrée précédente est, dans la plupart des cas, un processus simple. Les changements les plus importants découlent habituellement du fait que GameInput est centrée sur les entrées plutôt que sur les périphériques. Le code qui utilise les API précédentes énumère généralement les périphériques d’entrée avant de lire leurs entrées. Dans GameInput, toutefois, ce n’est pas nécessaire. L’adaptation au modèle centré sur les entrées de GameInput représente habituellement la majeure partie des modifications structurelles à apporter au code précédent qui sera porté.
Les rubriques suivantes fournissent des détails sur les différences entre GameInput et les API d’entrée précédentes. Ces rubriques comprennent aussi des exemples de code qui mettent en évidence les plus grandes différences entre les API.
Portage de Windows.Xbox.Input vers GameInput
Décrit le portage à partir de Windows.Xbox.Input du Software Development Kit XBOX One d’origine.
Portage de XInput vers GameInput
Décrit le portage à partir de XInput.
Utilisation de GameInput en parallèle avec les anciennes API
Pour les applications qui souhaitent utiliser du code GameInput en parallèle avec des interfaces et des API plus anciennes, l’API est suffisamment flexible pour permettre aussi ce cas d’utilisation. Cela permet aux applications de tirer facilement parti de nouvelles capacités comme la prise en charge des capteurs et de la rétroaction haptique sans remplacer l’ensemble de leurs piles d’entrée. À partir de la version 1 (v1),GameInputDeviceInfo contient un champ pnppath qui représente un chemin vers le périphérique sous-jacent. Ce champ est identique au chemin dans DIPROPGUIDANDPATH fourni par DirectInput. Il peut aussi être utilisé par les applications pour communiquer directement avec le périphérique en appelant CreateFile. Notez que les périphériques Game Input Protocol (GIP) autres que les manettes pourraient ne pas avoir cette propriété, car ils ne peuvent pas être ouverts directement.