> ## 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.

# XINPUT_STATE

> XINPUT_STATE

# XINPUT\_STATE

컨트롤러의 상태를 설명합니다.

## 구문

```cpp theme={null}
typedef struct XINPUT_STATE {  
    DWORD dwPacketNumber;  
    XINPUT_GAMEPAD Gamepad;  
} XINPUT_STATE  
```

### 멤버

*dwPacketNumber*\
형식: DWORD

상태 패킷 번호입니다. 패킷 번호는 컨트롤러의 상태가 변경되었는지 여부를 나타냅니다. 순차적으로 반환된 `XINPUT_STATE` 객체에서 값이 동일한 경우 컨트롤러 상태는 변경되지 않았습니다.

*Gamepad*\
형식: [XINPUT\_GAMEPAD](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)

컨트롤러의 현재 상태를 포함하는 [XINPUT\_GAMEPAD](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md) 객체입니다.

## 설명

*dwPacketNumber* 값은 컨트롤러가 마지막으로 폴링된 이후 컨트롤러의 상태가 변경된 경우에만 증가합니다.

이 구조체는 [XInputGetState](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstate.md) 및 [XInputGetStateWithToken](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md) 함수에서 사용됩니다.

자세한 내용은 [XInputOnGameInput 래퍼](https://docs.xbox.com/ko/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection)를 참조하세요.

## 요구 사항

**헤더:** XInputOnGameInput.h

**지원 플랫폼:** 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

- [XInputGetState](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XInputGetStateWithToken](https://docs.xbox.com/ko/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XInputOnGameInput (API 콘텐츠)](https://docs.xbox.com/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_VIBRATION](https://docs.xbox.com/ko/reference/input/xinputongameinput/structs/xinput_vibration.md)