> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XInputGetStateWithToken

> XInputGetStateWithToken

# XInputGetStateWithToken

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

## 구문

```cpp theme={null}
DWORD XInputGetStateWithToken(  
         DWORD dwUserIndex,  
         UINT64 framePipelineToken,  
         XINPUT_STATE * pState  
)  
```

### 매개변수

*dwUserIndex*   \_In\_\
형식: DWORD

장치와 연결된 게이머의 인덱스입니다. 값은 0에서 `XUSER_MAX_COUNT - 1` 범위입니다.

*framePipelineToken*   \_In\_\
형식: UINT64

D3DX 프레임 파이프라인 토큰입니다.

*pState*   \_Out\_\
형식: [XINPUT\_STATE](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_state.md)\*

컨트롤러의 현재 상태를 받는 [XINPUT\_STATE](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_state.md) 객체에 대한 포인터입니다.

### 반환값

형식: DWORD

함수가 성공하면 `ERROR_SUCCESS`를 반환합니다.

컨트롤러가 연결되어 있지 않으면 함수는 `ERROR_DEVICE_NOT_CONNECTED`를 반환합니다.

함수가 실패하면 WinError.h에 정의된 오류 코드를 반환합니다.

## 설명

이 함수는 [XInputGetState](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstate.md)와 유사하지만, 나중에 분석할 수 있도록 특정 입력 리딩을 그래픽 프레임과 연결합니다.

> [!NOTE]
>
> May Preview 릴리스부터, 기본 GameInput 코드가 완전히 구현되지 않았기 때문에 `XInputGetStateWithToken`의 동작은 `XInputGetState`와 동일합니다.

프레임 파이프라인 토큰을 제공하면 나중에 PIX 소프트웨어에서 입력 API 호출을 특정 그래픽 프레임과 상관 관계를 지을 수 있습니다.

## 요구 사항

**헤더:** XInputOnGameInput.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 참고 항목

[XInput에서 GameInput으로 이식](https://docs.xbox.com/ko/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/ko/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XINPUT_STATE](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_state.md)
- [XInputGetState](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XInput에서 GameInput으로 포팅](https://docs.xbox.com/ko/build/core-features/common/input/porting/input-porting-xinput.md)
- [XInputOnGameInput (API 콘텐츠)](https://docs.xbox.com/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [GetSensorsState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md)