Share via

IMFSimpleAudioVolume 介面 (mfidl.h)

  • 發行項

控制與串流音訊轉譯器相關聯的音訊會話主要音量層級， (SAR) 和音訊擷取來源。

SAR 和音訊擷取來源會將此介面公開為服務。 若要取得介面的指標，請呼叫 IMFGetService：：GetService。 針對 SAR，請使用服務識別碼MR_POLICY_VOLUME_SERVICE。 針對音訊擷取來源，請使用服務識別碼MR_CAPTURE_POLICY_VOLUME_SERVICE。 您可以直接在 SAR 或音訊擷取來源上呼叫 GetService ，或在媒體會話上呼叫它。

繼承

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

方法

IMFSimpleAudioVolume介面具有這些方法。

 
IMFSimpleAudioVolume：：GetMasterVolume

擷取主要磁片區層級。
IMFSimpleAudioVolume：：GetMute

查詢音訊是否靜音。 (IMFSimpleAudioVolume.GetMute)
IMFSimpleAudioVolume：：SetMasterVolume

設定主要磁片區層級。
IMFSimpleAudioVolume：：SetMute

將音訊靜音或取消靜音。 (IMFSimpleAudioVolume.SetMute)

備註

若要控制個別通道的磁片區層級，請使用 IMFAudioStreamVolume 介面。 僅限 SAR 支援 IMFAudioStreamVolume 介面。

磁片區會以衰減等級表示，其中 0.0 表示無聲，1.0 表示完整音量 (沒有衰減) 。 針對每個通道，衰減等級是下列專案的乘積：

  • 音訊會話的主要音量層級。
  • 通道的磁片區層級。
例如，如果主要磁碟區為 0.8，而通道磁片區為 0.5，該通道的衰減為 0.8 × 0.5 = 0.4。 音量層級可以超過 1.0 (正數提升) ，但音訊引擎會裁剪超過零分貝的任何音訊樣本。 若要變更個別通道的磁片區層級，請使用 IMFAudioStreamVolume 介面。

使用下列公式，將磁片區層級轉換成小數位數 (dB) 小數位數：

衰減 (dB) = 20 * log10 (層級)

例如，0.50 的磁片區層級代表衰減的 6.02 dB。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfidl.h

另請參閱

媒體基礎介面

串流音訊轉譯器