Skip to main content

XInputSetStateEx

将振动数据发送到指定的控制器。支持较新控制器的四电机振动功能。

语法

参数

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 有关详细信息,请参阅 XInputOnGameInput 包装器

要求

头文件: XInputOnGameInput.h 库: xgameruntime.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput
最后修改于 2026年8月24日