Portage de XInput vers GameInput

​

Différences clés

​

C ou 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():
    }
}

​

Rétroaction 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 les volants de course ou les sticks d’arcade, utilisez GameInput directement 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. C’est le cas indépendamment de tout appel àXInputEnable (ou de son absence).
• La valeur deXUSER_MAX_COUNT est passée de 4 à 8. Cela devrait généralement être transparent pour la plupart du code XInput existant. Cependant, assurez-vous d’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-après); elles ne devraient vous intéresser que si vous avez l’intention de continuer à utiliser le wrapper XInput dans du code de production.

​

Utilisation de XInputOnGameInput dans du code de production

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

  [!NOTE] Dans la version préliminaire de mai,XInputGetStateWithToken se comporte actuellement de façon identique àXInputGetState, 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é. Le passage de cet ID à la méthode FindDeviceFromId de IGameInput retourne l’interface IGameInputDevice correspondant à cet index d’utilisateur. Celle-ci peut ensuite être utilisée 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 de fonction du wrapper XInput sera 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; le prédicteur de branchement devrait donc atténuer le coût, mais il s’agit tout de même d’une surcharge supplémentaire.
3. Bien que cela ne devrait jamais échouer, il n’y a 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 avant le nettoyage des variables globales du wrapper XInput (soit en raison du déchargement du module, soit en raison 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