IAudioStreamVolume 接口 (audioclient.h)

借助 IAudioStreamVolume 接口，客户端可以控制和监视音频流中所有通道的音量级别。 客户端通过调用 IAudioClient：：GetService 方法（参数 riid 设置为 REFIID IID_IAudioStreamVolume）来获取对流对象上 IAudioStreamVolume 接口的引用。

会话子混合中任何通道的有效音量级别（如演讲者所听到）是以下四个音量级别因素的乘积：

• 会话中流的每通道音量级别，客户端可以通过 IAudioStreamVolume 接口中的方法控制这些级别。
• 会话的每通道音量级别，客户端可以通过 IChannelAudioVolume 接口中的方法控制该级别。
• 会话的主卷级别，客户端可以通过 ISimpleAudioVolume 接口中的方法控制该级别。
• 会话的基于策略的卷级别，当全局混合发生更改时，系统会动态分配给会话。

上述列表中的四个音量级别因子中的每一个都是 0.0 到 1.0 范围内的值，其中 0.0 表示静音，1.0 表示完整音量 (无衰减) 。 有效音量级别也是 0.0 到 1.0 范围内的值。

释放 IAudioStreamVolume 接口实例时，客户端必须从与调用创建对象的 IAudioClient：：GetService 相同的线程调用接口的 Release 方法。

IAudioStreamVolume 接口控制共享模式音频流中的通道音量。 此接口不适用于独占模式流。 有关独占模式流的卷控件的信息，请参阅 EndpointVolume API。

继承

IAudioStreamVolume 接口继承自 IUnknown 接口。 IAudioStreamVolume 还具有以下类型的成员：

方法

IAudioStreamVolume 接口具有这些方法。

IAudioStreamVolume：：GetAllVolumes GetAllVolumes 方法检索音频流中所有通道的音量级别。
IAudioStreamVolume：：GetChannelCount GetChannelCount 方法检索音频流中的通道数。
IAudioStreamVolume：：GetChannelVolume GetChannelVolume 方法检索音频流中指定通道的音量级别。
IAudioStreamVolume：：SetAllVolumes SetAllVolumes 方法设置音频流中所有通道的单个音量级别。
IAudioStreamVolume：：SetChannelVolume SetChannelVolume 方法设置音频流中指定通道的音量级别。

要求

要求	值
最低受支持的客户端	Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 | UWP 应用]
目标平台	Windows
标头	audioclient.h

另请参阅

核心音频接口

IAudioClient：：GetService

IChannelAudioVolume 接口

ISimpleAudioVolume 接口

WASAPI