XInput から GameInput への移植

​

主な違い

​

C と C++

​

入力の取得

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

​

ランブルフィードバック

​

アプリケーションのフォーカス

​

XInputOnGameInput ラッパー

#include <XInput.h>

#include <XInputOnGameInput.h>
using namespace XInputOnGameInput;

​

XInput と XInputOnGameInput の違い

• 簡潔さのために、ラッパーにはゲームパッドデバイスのサポートのみがコード化されています。レーシングホイールやアーケードスティックなど、他のデバイスをサポートする必要がある場合は、GameInput を直接使用するか、XInputOnGameInput コードにこれらのデバイスのサポートを追加してください。
• ラッパーは、ゲームがフォーカスされているときにのみゲームパッド入力を返します。ゲームがフォーカスされていない場合、返されるすべてのゲームパッドの状態は、ユーザーがゲームパッドに触れていないかのように、ニュートラルまたは「rest」値に設定されます。これは、XInputEnable への呼び出しの有無に関係なく行われます。
• XUSER_MAX_COUNT の値は 4 から 8 に増加されました。これは通常、ほとんどのレガシー XInput コードに対して透過的である必要があります。ただし、コード内での XInputGetKeystroke 関数の使用を慎重にレビューし、XINPUT_KEYSTROKE 構造体の UserIndex メンバーで返される最大値が 4 であることを前提としてハードコードされているものがないことを確認してください。そうしないと、バッファオーバーランが発生する可能性があります。
• いくつかの新しい関数が追加されました (下記参照)。これらは、本番コードで XInput ラッパーを引き続き使用する予定の場合にのみ関心があるはずです。

​

本番コードでの XInputOnGameInput の使用

• XInputSetStateEx は XInputSetState に似ていますが、トリガーモーターのサポートを追加します。
• XInputGetStateWithToken は XInputGetState に似ていますが、呼び出し元が特定の入力読み取りをグラフィックスフレームに関連付けて、後で PIX で分析するために D3DX フレームパイプライントークンを提供できます。

  [!NOTE] May Preview リリースでは、基盤となる GameInput コードが完全には実装されていないため、XInputGetStateWithToken は現在 XInputGetState と同じように動作します。

• XInputGetDeviceId は、指定されたユーザーインデックスのデバイスに対して APP_LOCAL_DEVICE_ID を返します。この ID を IGameInput の FindDeviceFromId メソッドに渡すと、そのユーザーインデックスに対応する IGameInputDevice が返されます。これを使用すると、XInput ラッパー経由では公開されていない GameInput API の追加機能にアクセスできます。

​

ラッパーコードの最適化

XINPUT_ON_GAMEINPUT_EXPLICIT_INITIALIZATION

1. 最初の XInput ラッパー関数呼び出しの実行時間は、通常よりも長くなります。
2. すべての XInput ラッパー関数は、呼び出されるたびに遅延初期化が実行されたかどうかをチェックする必要があります。これはグローバル変数の単純なテストなので、分岐予測子がコストを軽減するはずですが、余分なオーバーヘッドです。
3. 失敗することは決してないはずですが、基盤となる GameInput API の遅延初期化が成功したかどうかを判断する方法はありません。
4. 基盤となる IGameInput インスタンスは、XInput ラッパーのグローバル変数がクリーンアップされる (モジュールのアンロードまたはプロセスの終了のいずれかによる) まで解放されません。

XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE

XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE

​

リファレンス API ドキュメント

• GameInput (API 内容)
• XInputOnGameInput (API 内容)

​

関連項目