共用方式為


IAudioStreamVolume 介面 (audioclient.h)

IAudioStreamVolume 介面可讓用戶端控制及監視音訊數據流中所有通道的音量層級。 用戶端會呼叫 IAudioClient::GetService 方法,並將參數 riid 設定為 REFIID IID_IAudioStreamVolume,以取得數據流物件上 IAudioStreamVolume 介面的參考。

會話子混音中任何通道的有效音量層級,如說話者所聽見,是下列四個音量層級因素的乘積:

  • 會話中數據流的個別通道磁碟區層級,用戶端可以透過 IAudioStreamVolume 介面中的方法來控制。
  • 會話的每個通道磁碟區層級,用戶端可以透過 IChannelAudioVolume 介面中的方法來控制。
  • 會話的主要磁碟區層級,用戶端可以透過 ISimpleAudioVolume 介面中的方法來控制。
  • 會話的原則型磁碟區層級,系統會在全域混合變更時動態指派給會話。
上述清單中四個磁碟區層級因素中的每一個都是範圍 0.0 到 1.0 的值,其中 0.0 表示無聲,1.0 表示完整音量 (沒有衰減) 。 有效磁碟區層級也是範圍0.0到1.0的值。

釋放 IAudioStreamVolume 介面實例時,客戶端必須從與呼叫建立物件的 IAudioClient::GetService 相同的線程呼叫介面的 Release 方法。

IAudioStreamVolume 介面會控制共用模式音訊數據流中的通道磁碟區。 此介面不適用於獨佔模式數據流。 如需獨佔模式數據流之磁碟區控件的相關信息,請參閱 EndpointVolume API

繼承

IAudioStreamVolume 介面繼承自 IUnknown 介面。 IAudioStreamVolume 也有下列類型的成員:

方法

IAudioStreamVolume 介面具有這些方法。

 
IAudioStreamVolume::GetAllVolumes

GetAllVolumes 方法會擷取音訊數據流中所有通道的音量層級。
IAudioStreamVolume::GetChannelCount

GetChannelCount 方法會擷取音訊數據流中的通道數目。
IAudioStreamVolume::GetChannelVolume

GetChannelVolume 方法會擷取音訊數據流中指定通道的音量層級。
IAudioStreamVolume::SetAllVolumes

SetAllVolumes 方法會設定音訊數據流中所有通道的個別音量層級。
IAudioStreamVolume::SetChannelVolume

SetChannelVolume 方法會設定音訊數據流中指定通道的音量層級。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 audioclient.h

另請參閱

核心音訊介面

IAudioClient::GetService

IChannelAudioVolume 介面

ISimpleAudioVolume 介面

WASAPI