ISimpleAudioVolume 介面 (audioclient.h)
ISimpleAudioVolume 介面可讓用戶端控制音訊會話的主要音量層級。 IAudioClient::Initialize 方法會初始化數據流物件,並將數據流指派給音訊會話。 用戶端會呼叫 IAudioClient::GetService 方法,並將參數 riid 設定為 REFIID IID_ISimpleAudioVolume,以取得數據流物件上 ISimpleAudioVolume 介面的參考。
或者,用戶端可以取得現有會話的 ISimpleAudioVolume 介面,而不需要先建立數據流物件,並將數據流新增至會話。 相反地,用戶端會使用會話 GUID 呼叫 IAudioSessionManager::GetSimpleAudioVolume 方法。
會話子混音中任何通道的有效音量層級,如說話者所聽見,是下列四個音量層級因素的乘積:
- 會話中數據流的個別通道磁碟區層級,用戶端可以透過 IAudioStreamVolume 介面中的方法來控制。
- 會話的主要磁碟區層級,用戶端可以透過 ISimpleAudioVolume 介面中的方法來控制。
- 會話的每個通道磁碟區層級,用戶端可以透過 IChannelAudioVolume 介面中的方法來控制。
- 會話的原則型磁碟區層級,系統會在全域混合變更時動態指派給會話。
一般音訊應用程式不會修改會話的音量層級。 相反地,他們依賴使用者透過 Sndvol 程式來設定這些磁碟區層級。 Sndvol 只會修改會話的主要磁碟區層級。 根據預設,會話管理員會在會話的初始啟用時,將主要磁碟區層級設定為1.0。 Sndvol 或其他用戶端的後續磁碟區變更會在電腦重新啟動時持續發生。
釋放 ISimpleAudioVolume 介面實例時,客戶端必須從與呼叫建立物件的 IAudioClient::GetService 相同的線程呼叫介面的 Release 方法。
ISimpleAudioVolume 介面可控制音訊會話的音量。 音訊會話是共用模式數據流的集合。 此介面不適用於獨佔模式數據流。 如需獨佔模式數據流之磁碟區控件的相關信息,請參閱 EndpointVolume API。
繼承
ISimpleAudioVolume 介面繼承自 IUnknown 介面。 ISimpleAudioVolume 也有下列類型的成員:
方法
ISimpleAudioVolume 介面具有這些方法。
ISimpleAudioVolume::GetMasterVolume GetMasterVolume 方法會擷取音訊會話的用戶端音量層級。 |
ISimpleAudioVolume::GetMute GetMute 方法會擷取音訊會話目前的靜音狀態。 |
ISimpleAudioVolume::SetMasterVolume SetMasterVolume 方法會設定音訊會話的主要音量層級。 |
ISimpleAudioVolume::SetMute SetMute 方法會設定音訊會話的靜音狀態。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audioclient.h |