ISpatialAudioObject：：SetVolume 方法 (spatialaudioclient.h)
设置一个音频振幅乘数，该乘数将应用于 ISpatialAudioObject 提供的音频数据，然后再将其提交到音频呈现引擎。
语法
HRESULT SetVolume(
[in] float volume
);
参数
[in] volume
音频数据的振幅乘数。 此值必须是介于 0.0 和 1.0 之间的值。
返回值
如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。
| 返回代码 | 说明 |
|---|---|
|
在调用 SetVolume 之前，未调用 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。 |
|
在以前的音频处理过程中，已显式或隐式调用 SetEndOfStream。 如果未在音频处理中调用 GetBuffer，则系统会隐式调用 SetEndOfStream，并在调用 ISpatialAudioObjects 和 ISpatialAudioObjects) 之间 (。 |
注解
如果从未调用 SetVolume ，则使用默认值 1.0。 调用 SetVolume 后，设置的音量将用于音频对象，直到通过另一次调用 SetVolume 更改音量。
要求
| 目标平台 | Windows |
| 标头 | spatialaudioclient.h |