Skip to main content

XInputGetStateWithToken

지정된 컨트롤러의 현재 상태를 검색하고 D3DX 프레임 파이프라인 토큰과 연결합니다.

구문

매개변수

dwUserIndex   _In_
형식: DWORD
장치와 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. framePipelineToken   _In_
형식: UINT64
D3DX 프레임 파이프라인 토큰입니다. pState   _Out_
형식: XINPUT_STATE*
컨트롤러의 현재 상태를 받는 XINPUT_STATE 객체에 대한 포인터입니다.

반환값

형식: DWORD 함수가 성공하면 ERROR_SUCCESS를 반환합니다. 컨트롤러가 연결되어 있지 않으면 함수는 ERROR_DEVICE_NOT_CONNECTED를 반환합니다. 함수가 실패하면 WinError.h에 정의된 오류 코드를 반환합니다.

설명

이 함수는 XInputGetState와 유사하지만, 나중에 분석할 수 있도록 특정 입력 리딩을 그래픽 프레임과 연결합니다.
May Preview 릴리스부터, 기본 GameInput 코드가 완전히 구현되지 않았기 때문에 XInputGetStateWithToken의 동작은 XInputGetState와 동일합니다.
프레임 파이프라인 토큰을 제공하면 나중에 PIX 소프트웨어에서 입력 API 호출을 특정 그래픽 프레임과 상관 관계를 지을 수 있습니다.

요구 사항

헤더: XInputOnGameInput.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일