GetHapticInfo (v2)

提供有关输入设备的完整触觉属性和功能的动态信息。

语法

HRESULT GetHapticInfo(
    GameInputHapticInfo* info);

参数

info _Out_
类型： GameInputHapticInfo*

包含当前设备的触觉元数据的结构。

返回值

类型：HRESULT

GAMEINPUT_E_HAPTIC_NOT_FOUND如果触觉功能未准备就绪， (或当前设备) 不可用，则返回。

备注

方法 GetHapticInfo 查询当前设备的触觉元数据。由于触觉依赖于 Windows 音频堆栈，因此在设备到达时可能尚未提供此信息。强烈建议注册设备回调并等待GameInputDeviceHapticInfoReady设备状态通知，而不是在设备连接时调用 GetHapticInfo 方法。这样做可确保支持触觉的设备在轮询元数据之前获得初始化必要资源所需的时间。