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


## Related topics

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