XInput에서 GameInput으로 포팅

​

주요 차이점

​

C vs. 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와 유사하지만, 호출자가 D3DX 프레임 파이프라인 토큰을 제공하여 특정 입력 판독값을 그래픽 프레임과 연결해 나중에 PIX에서 분석할 수 있도록 합니다.

  [!NOTE] 5월 프리뷰 릴리스에서는 기반 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 콘텐츠)

​

함께 보기