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

# GAMEPAD_REPORT_EX

> GAMEPAD_REPORT_EX

# GAMEPAD\_REPORT\_EX

带有扩展信息的控制器状态快照。

## 语法

```cpp theme={null}
typedef struct GAMEPAD_REPORT_EX {  
    UINT16 Buttons;  
    UINT16 LeftTrigger;  
    UINT16 RightTrigger;  
    INT16 LeftThumbstickX;  
    INT16 LeftThumbstickY;  
    INT16 RightThumbstickX;  
    INT16 RightThumbstickY;  
    UINT32 MoreButtons;  
} GAMEPAD_REPORT_EX  
```

### 成员

*Buttons*\
类型：UINT16

[GAMEPAD\_BUTTONS](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md) 标志值的组合，表示控制器上按钮的状态。

*LeftTrigger*\
类型：UINT16

介于 0 和 1023 之间的值，表示左扳机的按下程度。

*RightTrigger*\
类型：UINT16

介于 0 和 1023 之间的值，表示右扳机的按下程度。

*LeftThumbstickX*\
类型：INT16

介于 -32768 和 32767 之间的值，表示左操纵杆在 x 轴上的位置。

*LeftThumbstickY*\
类型：INT16

介于 -32768 和 32767 之间的值，表示左操纵杆在 y 轴上的位置。

*RightThumbstickX*\
类型：INT16

介于 -32768 和 32767 之间的值，表示右操纵杆在 x 轴上的位置。

*RightThumbstickY*\
类型：INT16

介于 -32768 和 32767 之间的值，表示右操纵杆在 y 轴上的位置。

*MoreButtons*\
类型：UINT32

仅存在于 XBOX Series 控制器上的按钮。使用 GAMEPAD\_MORE\_BUTTONS 中的值作为掩码来指定这些按钮的状态。

## 要求

**头文件：** XtfInput.h
**库：** xtfinput.lib\
**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[XtfInput](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[SendGamepadReportEx](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [SendGamepadReportEx](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [SendGamepadReportWithAudio](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [XtfInput（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)
- [GAMEPAD_MORE_BUTTONS](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/enumerations/gamepad_more_buttons.md)
- [IXtfInputClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)