XInputSetStateEx

向指定控制器发送振动数据。 支持新控制器的四马达振动功能。

语法

DWORD XInputSetStateEx(  
         DWORD dwUserIndex,  
         const XINPUT_VIBRATION_EX * pVibration  
)  

参数

dwUserIndex _In_
类型:DWORD

与设备相关联的玩家的索引;介于 0 到 XUSER_MAX_COUNT - 1 之间的值。

pVibration _In_
类型:XINPUT_VIBRATION_EX*

指向包含要发送到控制器的振动信息的 XINPUT_VIBRATION_EX 对象的指针。

返回值

类型:DWORD

如果此函数成功,则返回 ERROR_SUCCESS

如果控制器未连接,则该函数将返回 ERROR_DEVICE_NOT_CONNECTED

如果该函数失败,则将返回在 WinError.h 中定义的错误代码。

备注

即使在与双电机控制器交互期间,调用此函数也是安全的。 将调整为双电机控制器发送到 XInputSetStateEx 的任何振动设置,以确保控制器仍以发送的输入的最佳近似值振动。 因此,我们建议您在要调用 XInputSetState 的情况下调用 XInputSetStateEx

有关详细信息,请参阅 The XInputOnGameInput 包装器

要求

头文件:XInputOnGameInput.h

库:xgameruntime.lib

支持的平台:Xbox One 系列主机和 Xbox Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput