IMFSimpleAudioVolume-Schnittstelle (mfidl.h)

  • Artikel

Steuert den master Lautstärkepegel der Audiositzung, die dem Streamingaudiorenderer (SAR) und der Audioaufnahmequelle zugeordnet ist.

Die SAR und die Audioaufnahmequelle machen diese Schnittstelle als Dienst verfügbar. Um einen Zeiger auf die Schnittstelle abzurufen, rufen Sie IMFGetService::GetService auf. Verwenden Sie für die SAR den Dienstbezeichner MR_POLICY_VOLUME_SERVICE. Verwenden Sie für die Audioaufnahmequelle den Dienstbezeichner MR_CAPTURE_POLICY_VOLUME_SERVICE. Sie können GetService direkt auf der SAR oder der Audioaufnahmequelle oder in der Mediensitzung aufrufen.

Vererbung

Die IMFSimpleAudioVolume-Schnittstelle erbt von der IUnknown-Schnittstelle . IMFSimpleAudioVolume verfügt auch über folgende Membertypen:

Methoden

Die IMFSimpleAudioVolume-Schnittstelle verfügt über diese Methoden.

 
IMFSimpleAudioVolume::GetMasterVolume

Ruft die master Volumeebene ab.
IMFSimpleAudioVolume::GetMute

Fragt ab, ob das Audio stummgeschaltet ist. (IMFSimpleAudioVolume.GetMute)
IMFSimpleAudioVolume::SetMasterVolume

Legt die master Volumeebene fest.
IMFSimpleAudioVolume::SetMute

Schaltet die Audio stumm oder hebt die Stummschaltung auf. (IMFSimpleAudioVolume.SetMute)

Hinweise

Um die Lautstärkestufen einzelner Kanäle zu steuern, verwenden Sie die IMFAudioStreamVolume-Schnittstelle . Die IMFAudioStreamVolume-Schnittstelle wird nur von der SAR unterstützt.

Die Lautstärke wird als Dämpfungsstufe ausgedrückt, wobei 0,0 die Stille und 1,0 die volle Lautstärke (keine Dämpfung) angibt. Für jeden Kanal ist die Dämpfungsebene das Produkt von:

  • Der master Lautstärkepegel der Audiositzung.
  • Die Lautstärkeebene des Kanals.
Wenn das master Volume beispielsweise 0,8 und das Kanalvolume 0,5 ist, beträgt die Dämpfung für diesen Kanal 0,8 × 0,5 = 0,4. Lautstärkepegel können 1,0 überschreiten (positive Verstärkung), aber die Audio-Engine schneidet alle Audiobeispiele ab, die null Dezibel überschreiten. Verwenden Sie die IMFAudioStreamVolume-Schnittstelle , um die Lautstärkeebene einzelner Kanäle zu ändern.

Verwenden Sie die folgende Formel, um die Volumeebene in die Dezibel-Skalierung (dB) zu konvertieren:

Dämpfung (dB) = 20 * log10(Level)

Ein Volumelevel von 0,50 stellt beispielsweise eine Dämpfung von 6,02 dB dar.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h

Weitere Informationen

Media Foundation-Schnittstellen

Streaming-Audiorenderer