Share via

IMFAudioStreamVolume-Schnittstelle (mfidl.h)

  • Artikel

Steuert die Lautstärken einzelner Audiokanäle.

Der Streamingaudiorenderer (SAR) macht diese Schnittstelle als Dienst verfügbar. Um einen Zeiger auf die Schnittstelle abzurufen, rufen Sie IMFGetService::GetService mit dem Dienstbezeichner MR_STREAM_VOLUME_SERVICE auf. Sie können GetService direkt in der SAR oder in der Mediensitzung aufrufen.

Vererbung

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

Methoden

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

 
IMFAudioStreamVolume::GetAllVolumes

Ruft die Lautstärkestufen für alle Kanäle im Audiodatenstrom ab.
IMFAudioStreamVolume::GetChannelCount

Ruft die Anzahl der Kanäle im Audiodatenstrom ab.
IMFAudioStreamVolume::GetChannelVolume

Ruft die Lautstärke für einen angegebenen Kanal im Audiodatenstrom ab.
IMFAudioStreamVolume::SetAllVolumes

Legt die einzelnen Lautstärken für alle Kanäle im Audiodatenstrom fest.
IMFAudioStreamVolume::SetChannelVolume

Legt die Lautstärke für einen angegebenen Kanal im Audiodatenstrom fest.

Hinweise

Wenn Ihre Anwendung keine Lautstärkeregelung auf Kanalebene erfordert, können Sie die IMFSimpleAudioVolume-Schnittstelle verwenden, um die master Lautstärke der Audiositzung zu steuern.

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

  • Die master Lautstärke 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. Die Lautstärke kann 1,0 (positive Verstärkung) überschreiten, aber die Audio-Engine schneidet alle Audiobeispiele ab, die null Dezibel überschreiten.

Verwenden Sie die folgende Formel, um die Lautstärkeebene in die Dezibelskalierung (dB) zu konvertieren:

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

Beispielsweise stellt eine Volumeebene von 0,50 6,02 dB der Dämpfung 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