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

# XINPUT_STATE

> XINPUT_STATE

# XINPUT\_STATE

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

<a id="syntaxSection" />

## 구문

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

<a id="membersSection" />

### 멤버

*dwPacketNumber*\
형식: DWORD

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

*Gamepad*\
형식: [XINPUT\_GAMEPAD](/reference/input/xinputongameinput/structs/xinput_gamepad)

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

<a id="remarksSection" />

## 설명

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

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

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

<a id="requirementsSection" />

## 요구 사항

**헤더:** XInputOnGameInput.h

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

<a id="seealsoSection" />

## 참고 항목

[XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XInputGetState](/ko/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XInputGetStateWithToken](/ko/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md)
- [XINPUT_GAMEPAD](/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_VIBRATION](/ko/reference/input/xinputongameinput/structs/xinput_vibration.md)