ISimpleAudioVolume 接口 (audioclient.h)
使用 ISimpleAudioVolume 接口,客户端可以控制音频会话的主音量级别。 IAudioClient::Initialize 方法初始化流对象并将流分配给音频会话。 客户端通过调用 IAudioClient::GetService 方法(参数 riid 设置为 REFIID IID_ISimpleAudioVolume)来获取对流对象上的 ISimpleAudioVolume 接口的引用。
或者,客户端可以获取现有会话的 ISimpleAudioVolume 接口,而无需先创建流对象并将流添加到会话。 相反,客户端使用会话 GUID 调用 IAudioSessionManager::GetSimpleAudioVolume 方法。
会话子混合中任何通道的有效音量级别(如演讲者所听到)是以下四个音量级别因素的乘积:
- 会话中流的每通道音量级别,客户端可以通过 IAudioStreamVolume 接口中的方法控制这些级别。
- 会话的主卷级别,客户端可以通过 ISimpleAudioVolume 接口中的方法控制该级别。
- 会话的每通道音量级别,客户端可以通过 IChannelAudioVolume 接口中的方法控制该级别。
- 会话的基于策略的卷级别,当全局混合发生更改时,系统会动态分配给会话。
典型的音频应用程序不会修改会话的音量级别。 相反,他们依赖于用户通过 Sndvol 程序设置这些卷级别。 Sndvol 仅修改会话的主卷级别。 默认情况下,会话管理器在会话的初始激活时将主卷级别设置为 1.0。 Sndvol 或其他客户端的后续卷更改在计算机重启后会持续进行。
释放 ISimpleAudioVolume 接口实例时,客户端必须从与调用创建对象的 IAudioClient::GetService 相同的线程调用接口的 Release 方法。
ISimpleAudioVolume 接口控制音频会话的音量。 音频会话是共享模式流的集合。 此接口不适用于独占模式流。 有关独占模式流的卷控件的信息,请参阅 EndpointVolume API。
继承
ISimpleAudioVolume 接口继承自 IUnknown 接口。 ISimpleAudioVolume 也有以下类型的成员:
方法
ISimpleAudioVolume 接口具有这些方法。
ISimpleAudioVolume::GetMasterVolume GetMasterVolume 方法检索音频会话的客户端音量级别。 |
ISimpleAudioVolume::GetMute GetMute 方法检索音频会话的当前静音状态。 |
ISimpleAudioVolume::SetMasterVolume SetMasterVolume 方法设置音频会话的主音量级别。 |
ISimpleAudioVolume::SetMute SetMute 方法设置音频会话的静音状态。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | audioclient.h |