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

描述控制器的狀態。

## 語法

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

### 成員

*dwPacketNumber*\
類型：DWORD

狀態封包編號。封包編號會指出控制器的狀態是否已變更。如果依序傳回的 `XINPUT_STATE` 物件中的值相同，表示控制器狀態未變更。

*Gamepad*\
類型：[XINPUT\_GAMEPAD](/zh-TW/reference/input/xinputongameinput/structs/xinput_gamepad.md)

包含控制器目前狀態的 [XINPUT\_GAMEPAD](/zh-TW/reference/input/xinputongameinput/structs/xinput_gamepad.md) 物件。

## 備註

只有在控制器狀態自上次輪詢控制器後有所變更時，*dwPacketNumber* 的值才會遞增。

此結構由 [XInputGetState](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstate.md) 和 [XInputGetStateWithToken](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md) 函式使用。

如需詳細資訊，請參閱 [XInputOnGameInput 包裝函式](/zh-TW/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection)。

## 需求

**標頭：** XInputOnGameInput.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[從 XInput 移植到 GameInput](/zh-TW/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](/zh-TW/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetState](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XInputGetStateWithToken](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstatewithtoken.md)
- [XINPUT_GAMEPAD](/zh-TW/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XInputOnGameInput (API 內容)](/zh-TW/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_VIBRATION](/zh-TW/reference/input/xinputongameinput/structs/xinput_vibration.md)