Portage de XInput vers GameInput

​

Différences clés

​

C et C++

​

Obtention des entrées

// This function looks for a gamepad that currently has the "A" button pressed.
void FindActiveGamepad()
{
    for (DWORD index = 0; index < XUSER_MAX_COUNT; index++)
    {
        XINPUT_STATE state;
        if (XInputGetState(index, &state) == ERROR_SUCCESS)
        {
            if (state.Gamepad.wButtons & XINPUT_GAMEPAD_A)
            {
                // Found the user's gamepad at this index.
            }
        }
    }
}

// This function looks for a gamepad that currently has the "A" button pressed.
void FindActiveGamepad(IGameInput * gameInput)
{
    // This checks for input from all gamepads simultaneously.
    IGameInputReading * reading;
    if (SUCCEEDED(gameInput->GetCurrentReading(GameInputKindGamepad, nullptr, &reading)))
    {
        GameInputGamepadState state;
        reading->GetGamepadState(&state);

        if (state.buttons & GameInputGamepadA)
        {
            // Found the user's gamepad.  At this point we can
            // get the device that generated this input, and then
            // pass that into future calls to the GetCurrentReading
            // method to receive input only from that gamepad.
        }

        reading->Release():
    }
}

​

Retour par vibration

​

Focus de l’application

​

Le wrapper XInputOnGameInput

#include <XInput.h>

#include <XInputOnGameInput.h>
using namespace XInputOnGameInput;

​

Différences entre XInput et XInputOnGameInput

• Par souci de simplicité, seule la prise en charge des manettes a été codée dans le wrapper. Si vous devez prendre en charge d’autres périphériques, comme des volants de course ou des sticks arcade, utilisez directement GameInput ou ajoutez la prise en charge de ces périphériques dans le code de XInputOnGameInput.
• Le wrapper ne retourne les entrées de manette que lorsque le jeu a le focus. Lorsque le jeu n’a pas le focus, tout état de manette retourné est défini sur des valeurs neutres ou « au repos », comme si l’utilisateur ne touchait pas la manette. Ce comportement s’applique indépendamment des appels àXInputEnable (ou de leur absence).
• La valeur deXUSER_MAX_COUNT est passée de 4 à 8. Cela devrait généralement être transparent pour la plupart des anciens codes XInput. Veillez toutefois à examiner attentivement toute utilisation de la fonctionXInputGetKeystroke dans votre code pour vous assurer que rien n’est codé en dur en supposant une valeur maximale de 4 retournée dans le membreUserIndex de la structureXINPUT_KEYSTROKE. Sinon, un dépassement de mémoire tampon pourrait se produire.
• Quelques nouvelles fonctions ont été ajoutées (voir ci-dessous) ; elles ne présentent d’intérêt que si vous prévoyez de continuer à utiliser le wrapper XInput dans du code de production.

​

Utilisation de XInputOnGameInput dans du code de production

• XInputSetStateEx est similaire àXInputSetState, mais ajoute la prise en charge des moteurs de gâchettes.
• XInputGetStateWithToken est similaire àXInputGetState, mais permet à l’appelant de fournir un jeton de pipeline d’images D3DX afin d’associer une lecture d’entrée spécifique à une image graphique en vue d’une analyse ultérieure dans PIX.

  [!NOTE] Dans la version May Preview,XInputGetStateWithToken se comporte actuellement de la même manière queXInputGetState, car le code GameInput sous-jacent n’est pas entièrement implémenté.

• XInputGetDeviceId retourne leAPP_LOCAL_DEVICE_ID du périphérique associé à un index d’utilisateur donné. La transmission de cet ID à la méthode FindDeviceFromId de IGameInput retourne le IGameInputDevice correspondant à cet index d’utilisateur. Celui-ci peut ensuite être utilisé pour accéder à des fonctionnalités supplémentaires de l’API GameInput qui ne sont pas exposées par le wrapper XInput.

​

Optimisation du code du wrapper

XINPUT_ON_GAMEINPUT_EXPLICIT_INITIALIZATION

1. Le temps d’exécution du premier appel à une fonction du wrapper XInput est plus long que d’habitude.
2. Chaque fonction du wrapper XInput doit vérifier, à chaque appel, si l’initialisation différée a été effectuée. Il s’agit d’un simple test d’une variable globale, ce qui permet au prédicteur de branchement d’en atténuer le coût, mais cela reste une surcharge supplémentaire.
3. Bien qu’elle ne doive jamais échouer, il n’existe aucun moyen de savoir si l’initialisation différée de l’API GameInput sous-jacente a réussi.
4. L’instance IGameInput sous-jacente n’est pas libérée tant que les variables globales du wrapper XInput ne sont pas nettoyées (soit lors du déchargement du module, soit lors de l’arrêt du processus).

XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE

XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE

​

Documentation de référence de l’API

• GameInput (contenu de l’API)
• XInputOnGameInput (contenu de l’API)

​

Voir aussi