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