從 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 程式碼中新增對這些裝置的支援。
• 包裝函式只會在遊戲取得焦點時傳回遊戲台輸入。當遊戲未取得焦點時，傳回的任何遊戲台狀態都會設為中性或「靜止」值，就像使用者沒有碰觸遊戲台一樣。無論是否呼叫XInputEnable，都會如此處理。
• XUSER_MAX_COUNT 的值已從 4 增加為 8。對於大多數舊版 XInput 程式碼而言，這通常是透明的。不過，請務必仔細檢閱程式碼中對XInputGetKeystroke 函式的任何使用，以協助確保沒有任何程式碼寫死假設XINPUT_KEYSTROKE 結構的UserIndex 成員中傳回的最大值為 4。否則，可能會發生緩衝區溢位。
• 已新增一些新函式 (請參閱下文)，只有在您打算在生產程式碼中繼續使用 XInput 包裝函式時，這些函式才會有用。

​

在生產程式碼中使用 XInputOnGameInput

• XInputSetStateEx 與XInputSetState 類似，但新增了對扳機馬達的支援。
• XInputGetStateWithToken 與XInputGetState 類似，但允許呼叫端提供 D3DX 畫面管線權杖，將特定輸入讀數與圖形畫面產生關聯，以便稍後在 PIX 中進行分析。

  [!NOTE] 在 May Preview 版本中，XInputGetStateWithToken 目前的行為與XInputGetState 相同，因為基礎的 GameInput 程式碼尚未完全實作。

• XInputGetDeviceId 會傳回指定使用者索引之裝置的APP_LOCAL_DEVICE_ID。將此識別碼傳遞至 IGameInput 上的 FindDeviceFromId 方法，會傳回該使用者索引對應的 IGameInputDevice。然後可以使用它來存取 GameInput API 中未透過 XInput 包裝函式公開的其他功能。

​

最佳化包裝函式程式碼

XINPUT_ON_GAMEINPUT_EXPLICIT_INITIALIZATION

1. 第一次呼叫 XInput 包裝函式的執行時間會比平常長。
2. 每個 XInput 包裝函式在每次呼叫時，都必須檢查是否已執行延遲初始化。這只是對全域變數的簡單測試，因此分支預測器應該能降低成本，但仍是額外的負擔。
3. 雖然它應該永遠不會失敗，但無法得知基礎 GameInput API 的延遲初始化是否成功。
4. 在 XInput 包裝函式的全域變數清除之前 (由於模組卸載或處理序終止)，基礎的 IGameInput 執行個體不會釋放。

XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE

XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE

​

參考 API 文件

• GameInput (API 內容)
• XInputOnGameInput (API 內容)

​

另請參閱