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