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 |