Windows 径向控制器输出报告

本主题详细介绍了用于 Windows 10 版本 1607 及更高版本的操作系统中径向控制器触觉反馈支持的 HID 输出报告。

触觉反馈集合（可选）

如果 Windows 径向控制器设备支持触觉反馈，你可以通过在 Windows 径向控制器 TLC 中包括触觉反馈集合（页面为 0x0E，用法为 0x01）来让系统和应用程序利用触觉反馈。 若要详细了解 HID 规范如何支持触觉反馈，请参阅针对 HID 规范的触觉页面认可。

主机在输出报告中（通过触觉反馈集合）使用以下用法，以允许主机向 Windows 径向控制器设备发出触觉反馈事件。 如果设备选择公开触觉反馈集合，则必须使用某些用法来支持主机启动的触觉反馈。

成员	说明	页	ID	必需/可选
手动触发器	要作为来自主机的显式命令触发的波形。	0x0E	0x21	必需
强度	输出 - 手动触发器波形的强度百分比	0x0E	0x23	可选
重复计数	输出 - 初始播放后播放手动触发器波形的次数	0x0E	0x24	可选
重新触发周期	输出 - 重复操作时重新触发手动触发器之前的等待时间	0x0E	0x25	可选

手动触发器

手动触发器用法表示主机已请求播放的波形列表中支持的波形用法。 当包含除 WAVEFORM_NONE 之外的手动触发器的输出报告发送到设备时，它应立即开始播放指定的波形，并使用输出报告中包含的附加属性（强度、重复计数、重新触发周期）。 当输出报告包含 WAVEFORM_STOP 的手动触发器时，应停止任何正在进行的波形回放。

强度

“强度”用法表示应用于波形的最大强度的百分比。 该值应在 0% 到 100% 之间变化。 100% 表示设备将以最大强度触发波形，0% 表示未启用触觉传感器。

在输出报告中设置时，此值将覆盖在同一输出报告中定义的手动触发器波形的默认强度。 这不会设置新的默认强度。

重复次数

重复计数用法表示重复某个波形的次数。 重复计数为零表示手动触发器波形应仅播放一次（不重复）。 如果超过了波形截止时间，预计任何不完整的重复都会被忽略。

在输出报告中设置时，此值会覆盖在同一输出报告中定义的手动触发器波形的默认重复计数。 这不会设置新的默认重复计数。

重新触发周期

“重新触发周期”用法表示设备根据重复计数指定的值在输出报告中重复手动触发器波形之前等待的时间量。 此值的单位是毫秒。 如果重新触发周期小于正在播放的波形的持续时间，则应在重新触发周期指示的时间段停止波形并重启它。

在输出报告中设置时，它会覆盖在同一输出报告中定义的手动触发器波形的默认重新触发周期。 这不会设置新的默认重新触发周期。