ISpatialAudioObjectForHrtf：：SetGain 方法 (spatialaudiohrtf.h)

  • 项目

以 dB 为单位设置 ISpatialAudioObjectForHrtf 的增益。

语法

HRESULT SetGain(
  [in] float gain
);

参数

[in] gain

dB 中 ISpatialAudioObjectForHrtf 的增益。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
SPTLAUDCLNT_E_OUT_OF_ORDER

在调用 SetGain 之前，未调用 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。
SPTLAUDCLNT_E_RESOURCES_INVALIDATED

在以前的音频处理过程中，已显式或隐式调用 SetEndOfStream。 如果未在音频处理中调用 GetBuffer，则系统会隐式调用 SetEndOfStream，并在调用 ISpatialAudioObjects 和 ISpatialAudioObjects) 之间 (。

注解

这仅适用于配置为使用 SpatialAudioHrtfDistanceDecay_CustomDecay 衰减类型的空间音频对象。 通过调用 SetDistanceDecay 设置 ISpatialAudioObjectForHrtf 对象的衰减类型。 通过设置传递到 ISpatialAudioClient：：ActivateSpatialAudioStream 的 SpatialAudioHrtfActivationParams 的 DistanceDecay 字段，为 HRTF 呈现流中的所有对象设置默认衰减类型。

如果从不调用 SetGain ，则使用默认值 0.0。 调用 SetGain 后，设置的增益将用于音频对象，直到通过另一次调用 SetGain 更改增益。

要求

要求 值
目标平台 Windows
标头 spatialaudiohrtf.h

另请参阅

ISpatialAudioObjectForHrtf