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

# 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](/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t) 标志值的组合，表示控制器上按钮的状态。

*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](/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n)\
[SendGamepadReportEx](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex)\
[IXtfInputClient::ConnectGamepad](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m)


## Related topics

- [IXtfInputClient::SendGamepadReportEx](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [IXtfInputClient::SendGamepadReportWithAudio](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [GAMEPAD_MORE_BUTTONS](/zh-CN/reference/tools/xtf/xtfinput/enumerations/gamepad_more_buttons.md)
- [GAMEPAD_REPORT structure](/zh-CN/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [IXtfInputClient::SendGamepadReport Method](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)