Portabilidad de XInput a GameInput

​

Diferencias clave

​

C frente a C++

​

Obtención 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():
    }
}

​

Retroalimentación de vibración

​

Foco de la aplicación

​

El contenedor XInputOnGameInput

#include <XInput.h>

#include <XInputOnGameInput.h>
using namespace XInputOnGameInput;

​

Diferencias entre XInput y XInputOnGameInput

• Para simplificar, en el contenedor solo se ha codificado la compatibilidad con dispositivos de tipo mando. Si necesita compatibilidad con otros dispositivos, como volantes de carreras o joysticks arcade, use GameInput directamente o agregue compatibilidad con esos dispositivos en el código de XInputOnGameInput.
• El contenedor devolverá entrada del mando solo cuando el juego tenga el foco. Cuando el juego no tiene el foco, cualquier estado de mando devuelto se establece en valores neutros o de “reposo”, como si el usuario no estuviera tocando el mando. Esto se hace independientemente de las llamadas aXInputEnable (o de la ausencia de ellas).
• El valor deXUSER_MAX_COUNT se ha aumentado de 4 a 8. En general, esto debería ser transparente para la mayoría del código de XInput heredado. Sin embargo, asegúrese de revisar cuidadosamente cualquier uso de la funciónXInputGetKeystroke en su código para garantizar que nada esté codificado de forma rígida asumiendo que se devuelve un valor máximo de 4 en el miembroUserIndex de la estructuraXINPUT_KEYSTROKE. De lo contrario, podría producirse una saturación del búfer.
• Se han agregado algunas funciones nuevas (vea a continuación) que solo deberían interesarle si tiene previsto seguir usando el contenedor de XInput en código de producción.

​

Uso de XInputOnGameInput en código de producción

• XInputSetStateEx es similar aXInputSetState, pero agrega compatibilidad con los motores de los gatillos.
• XInputGetStateWithToken es similar aXInputGetState, pero permite al autor de la llamada proporcionar un token de canalización de fotogramas de D3DX para asociar una lectura de entrada específica con un fotograma de gráficos y analizarla posteriormente en PIX.

  [!NOTE] En la versión May Preview,XInputGetStateWithToken se comporta actualmente de manera idéntica aXInputGetState, porque el código subyacente de GameInput no está completamente implementado.

• XInputGetDeviceId devuelve elAPP_LOCAL_DEVICE_ID del dispositivo en un índice de usuario determinado. Al pasar este identificador al método FindDeviceFromId de IGameInput, se devuelve el IGameInputDevice correspondiente a ese índice de usuario. Este puede usarse después para acceder a funcionalidad adicional de la API de GameInput que no está expuesta a través del contenedor de XInput.

​

Optimización del código del contenedor

XINPUT_ON_GAMEINPUT_EXPLICIT_INITIALIZATION

1. El tiempo de ejecución de la primera llamada a una función del contenedor de XInput será más largo de lo habitual.
2. Cada función del contenedor de XInput debe realizar una comprobación para ver si se ha efectuado la inicialización diferida cada vez que se la llama. Se trata de una simple comprobación de una variable global, por lo que el predictor de saltos debería mitigar el costo, pero es una sobrecarga adicional.
3. Aunque nunca debería fallar, no hay forma de saber si la inicialización diferida de la API de GameInput subyacente se realizó correctamente.
4. La instancia subyacente de IGameInput no se libera hasta que se limpian las variables globales del contenedor de XInput (ya sea por la descarga del módulo o por la finalización del proceso).

XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE

XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE

​

Documentación de referencia de la API

• GameInput (contenido de la API)
• XInputOnGameInput (contenido de la API)

​

Consulte también