Portabilidade do XInput para o GameInput

​

Principais diferenças

​

C vs. C++

​

Obtenção de entrada

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

​

Resposta de vibração

​

Foco do aplicativo

​

O wrapper XInputOnGameInput

#include <XInput.h>

#include <XInputOnGameInput.h>
using namespace XInputOnGameInput;

​

Diferenças entre o XInput e o XInputOnGameInput

• Para simplificar, apenas o suporte a dispositivos gamepad foi codificado no wrapper. Se você precisar dar suporte a outros dispositivos, como volantes de corrida ou arcade sticks, use o GameInput diretamente ou adicione suporte a esses dispositivos no código do XInputOnGameInput.
• O wrapper retornará a entrada do gamepad somente quando o jogo estiver em foco. Quando o jogo não estiver em foco, qualquer estado de gamepad retornado é definido com valores neutros ou de “repouso”, como se o usuário não estivesse tocando no gamepad. Isso é feito independentemente de quaisquer chamadas aXInputEnable (ou da falta delas).
• O valor deXUSER_MAX_COUNT foi aumentado de 4 para 8. Em geral, isso deve ser transparente para a maior parte do código XInput legado. No entanto, revise cuidadosamente qualquer uso da funçãoXInputGetKeystroke no seu código para ajudar a garantir que nada esteja codificado para presumir um valor máximo de 4 retornado no membroUserIndex da estruturaXINPUT_KEYSTROKE. Caso contrário, poderá ocorrer uma saturação de buffer.
• Algumas novas funções foram adicionadas (veja a seguir), que devem interessar apenas se você pretende continuar usando o wrapper XInput em código de produção.

​

Uso do XInputOnGameInput em código de produção

• XInputSetStateEx é semelhante aXInputSetState, mas adiciona suporte aos motores dos gatilhos.
• XInputGetStateWithToken é semelhante aXInputGetState, mas permite que o chamador forneça um token de pipeline de quadro D3DX para associar uma leitura de entrada específica a um quadro gráfico para análise posterior no PIX.

  [!NOTE] Na versão May Preview,XInputGetStateWithToken atualmente se comporta de forma idêntica aXInputGetState, porque o código subjacente do GameInput não está totalmente implementado.

• XInputGetDeviceId retorna oAPP_LOCAL_DEVICE_ID do dispositivo em um determinado índice de usuário. Passar essa ID para o método FindDeviceFromId em IGameInput retorna o IGameInputDevice correspondente a esse índice de usuário. Isso pode então ser usado para acessar funcionalidades adicionais da API GameInput que não são expostas pelo wrapper XInput.

​

Otimização do código do wrapper

XINPUT_ON_GAMEINPUT_EXPLICIT_INITIALIZATION

1. O tempo de execução da primeira chamada de função do wrapper XInput será maior do que o normal.
2. Toda função do wrapper XInput precisa verificar se a inicialização lenta foi realizada sempre que é chamada. Esse é um teste simples de uma variável global, portanto, o preditor de desvios deve amenizar o custo, mas é uma sobrecarga extra.
3. Embora nunca deva falhar, não há como saber se a inicialização lenta da API GameInput subjacente foi bem-sucedida.
4. A instância subjacente de IGameInput não é liberada até que as variáveis globais do wrapper XInput sejam limpas (seja devido ao descarregamento do módulo ou ao encerramento do processo).

XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE

XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE

​

Documentação de referência da API

• GameInput (conteúdo da API)
• XInputOnGameInput (conteúdo da API)

​

Confira também