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 主机