ISpatialAudioObject：：SetVolume 方法 (spatialaudioclient.h)

  • 项目

设置一个音频振幅乘数，该乘数将应用于 ISpatialAudioObject 提供的音频数据，然后再将其提交到音频呈现引擎。

语法

HRESULT SetVolume(
  [in] float volume
);

参数

[in] volume

音频数据的振幅乘数。 此值必须是介于 0.0 和 1.0 之间的值。

返回值

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

返回代码 说明
SPTLAUDCLNT_E_OUT_OF_ORDER

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

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

注解

如果从未调用 SetVolume ，则使用默认值 1.0。 调用 SetVolume 后，设置的音量将用于音频对象，直到通过另一次调用 SetVolume 更改音量。

要求

   
目标平台 Windows
标头 spatialaudioclient.h

另请参阅

ISpatialAudioObject