IAudioSessionEvents 接口 (audiopolicy.h)

IAudioSessionEvents 接口提供会话相关事件的通知，例如卷级别、显示名称和会话状态的更改。 与本部分中由 WASAPI 系统组件实现的其他接口不同，WASAPI 客户端实现 IAudioSessionEvents 接口。 为了接收事件通知，客户端将指向其 IAudioSessionEvents 接口的指针传递到 IAudioSessionControl：：RegisterAudioSessionNotification 方法。

注册其 IAudioClientSessionEvents 接口后，客户端通过接口中的 方法以回调的形式接收事件通知。

在实现 IAudioSessionEvents 接口时，客户端应遵守以下规则，以避免死锁和未定义的行为：

• 接口中的方法必须是非阻止的。 在事件回调期间，客户端不应等待同步对象。
• 客户端不应在事件回调期间调用 IAudioSessionControl：：UnregisterAudioSessionNotification 方法。
• 客户端不应在事件回调期间释放 WASAPI 对象上的最终引用。

有关实现 IAudioSessionEvents 接口的 代码示例，请参阅 音频会话事件。 有关注册客户端 IAudioSessionEvents 接口以接收通知的代码示例，请参阅 旧版音频应用程序的音频事件。

继承

IAudioSessionEvents 接口继承自 IUnknown 接口。 IAudioSessionEvents 也有以下类型的成员：

方法

IAudioSessionEvents 接口具有这些方法。

IAudioSessionEvents：：OnChannelVolumeChanged OnChannelVolumeChanged 方法通知客户端会话子混合中音频通道的音量级别已更改。
IAudioSessionEvents：：OnDisplayNameChanged OnDisplayNameChanged 方法通知客户端会话的显示名称已更改。
IAudioSessionEvents：：OnGroupingParamChanged OnGroupingParamChanged 方法通知客户端会话的分组参数已更改。
IAudioSessionEvents：：OnIconPathChanged OnIconPathChanged 方法通知客户端会话的显示图标已更改。
IAudioSessionEvents：：OnSessionDisconnected OnSessionDisconnected 方法通知客户端音频会话已断开连接。
IAudioSessionEvents：：OnSimpleVolumeChanged OnSimpleVolumeChanged 方法通知客户端音频会话的音量级别或静音状态已更改。
IAudioSessionEvents：：OnStateChanged OnStateChanged 方法通知客户端会话的流活动状态已更改。

要求

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

另请参阅

核心音频接口

IAudioSessionControl：：RegisterAudioSessionNotification

IAudioSessionControl：：UnregisterAudioSessionNotification

WASAPI