ISpatialAudioObjectForHrtf：：SetGain 方法 (spatialaudiohrtf.h)
以 dB 为单位设置 ISpatialAudioObjectForHrtf 的增益。
语法
HRESULT SetGain(
[in] float gain
);
参数
[in] gain
dB 中 ISpatialAudioObjectForHrtf 的增益。
返回值
如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。
| 返回代码 | 说明 |
|---|---|
|
在调用 SetGain 之前，未调用 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。 |
|
在以前的音频处理过程中，已显式或隐式调用 SetEndOfStream。 如果未在音频处理中调用 GetBuffer，则系统会隐式调用 SetEndOfStream，并在调用 ISpatialAudioObjects 和 ISpatialAudioObjects) 之间 (。 |
注解
这仅适用于配置为使用 SpatialAudioHrtfDistanceDecay_CustomDecay 衰减类型的空间音频对象。 通过调用 SetDistanceDecay 设置 ISpatialAudioObjectForHrtf 对象的衰减类型。 通过设置传递到 ISpatialAudioClient：：ActivateSpatialAudioStream 的 SpatialAudioHrtfActivationParams 的 DistanceDecay 字段，为 HRTF 呈现流中的所有对象设置默认衰减类型。
如果从不调用 SetGain ，则使用默认值 0.0。 调用 SetGain 后，设置的增益将用于音频对象，直到通过另一次调用 SetGain 更改增益。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | spatialaudiohrtf.h |