IMFAudioStreamVolume-Schnittstelle (mfidl.h)
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.
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 |