IAudioSessionControl 接口 (audiopolicy.h)

IAudioSessionControl 接口使客户端能够配置音频会话的控制参数并监视会话中的事件。 IAudioClient::Initialize 方法初始化流对象并将流分配给音频会话。 客户端通过调用 IAudioClient::GetService 方法(参数 riid 设置为 REFIID IID_IAudioSessionControl)来获取对流对象上 IAudioSessionControl 接口的引用。

或者,客户端可以获取现有会话的 IAudioSessionControl 接口,而无需先创建流对象并将流添加到会话。 相反,客户端调用 IAudioSessionManager::GetAudioSessionControl 方法,并将参数 AudioSessionGuid 设置为会话 GUID。

当客户端通过 IAudioSessionControl 接口中的方法更改会话参数时,客户端可以注册以接收来自会话管理器的通知。

释放 IAudioSessionControl 接口实例时,客户端必须从调用创建对象的 IAudioClient::GetService 的同一线程调用接口的 Release 方法。

IAudioSessionControl 接口控制音频会话。 音频会话是共享模式流的集合。 此接口不适用于独占模式流。

有关使用 IAudioSessionControl 接口的代码示例,请参阅 旧版音频应用程序的音频事件

继承

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

方法

IAudioSessionControl 接口包含以下方法。

 
IAudioSessionControl::GetDisplayName

GetDisplayName 方法检索音频会话的显示名称。
IAudioSessionControl::GetGroupingParam

GetGroupingParam 方法检索音频会话的分组参数。
IAudioSessionControl::GetIconPath

GetIconPath 方法检索音频会话的显示图标的路径。
IAudioSessionControl::GetState

GetState 方法检索音频会话的当前状态。
IAudioSessionControl::RegisterAudioSessionNotification

RegisterAudioSessionNotification 方法注册客户端以接收会话事件的通知,包括流状态的更改。
IAudioSessionControl::SetDisplayName

SetDisplayName 方法将显示名称分配给当前会话。
IAudioSessionControl::SetGroupingParam

SetGroupingParam 方法将会话分配给会话分组。
IAudioSessionControl::SetIconPath

SetIconPath 方法将显示图标分配给当前会话。
IAudioSessionControl::UnregisterAudioSessionNotification

UnregisterAudioSessionNotification 方法删除客户端先前的注册以接收通知。

要求

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

另请参阅

核心音频接口

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI