IAudioStreamVolume-Schnittstelle (audioclient.h)

Die IAudioStreamVolume-Schnittstelle ermöglicht es einem Client, die Lautstärken für alle Kanäle in einem Audiostream zu steuern und zu überwachen. Der Client ruft einen Verweis auf die IAudioStreamVolume-Schnittstelle in einem Streamobjekt ab, indem er die IAudioClient::GetService-Methode aufruft, wobei der Parameter riid auf REFIID IID_IAudioStreamVolume festgelegt ist.

Die effektive Lautstärke eines beliebigen Kanals im Sitzungs-Submix, wie er von den Lautsprechern gehört wird, ist das Produkt der folgenden vier Faktoren auf Lautstärkeebene:

• Die Volumeebenen pro Kanal der Streams in der Sitzung, die Clients über die Methoden in der IAudioStreamVolume-Schnittstelle steuern können.
• Die Volumeebene pro Kanal der Sitzung, die Clients über die Methoden in der IChannelAudioVolume-Schnittstelle steuern können.
• Die master Volumeebene der Sitzung, die Clients über die Methoden in der ISimpleAudioVolume-Schnittstelle steuern können.
• Die richtlinienbasierte Volumeebene der Sitzung, die das System dynamisch der Sitzung zuweist, wenn sich die globale Mischung ändert.

Jeder der vier Faktoren auf Volumeebene in der vorherigen Liste ist ein Wert im Bereich von 0,0 bis 1,0, wobei 0,0 für Stille und 1,0 für volle Lautstärke (keine Dämpfung) steht. Die effektive Volumeebene ist ebenfalls ein Wert im Bereich von 0,0 bis 1,0.

Beim Freigeben einer IAudioStreamVolume-Schnittstelle instance muss der Client die Release-Methode der Schnittstelle aus demselben Thread aufrufen wie der Aufruf von IAudioClient::GetService, der das Objekt erstellt hat.

Die IAudioStreamVolume-Schnittstelle steuert die Kanalvolumes in einem Audiostream im freigegebenen Modus. Diese Schnittstelle funktioniert nicht mit Datenströmen im exklusiven Modus. Informationen zu Volumesteuerelementen für Datenströme im exklusiven Modus finden Sie unter EndpointVolume-API.

Vererbung

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

Methoden

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

IAudioStreamVolume::GetAllVolumes Die GetAllVolumes-Methode ruft die Lautstärkepegel für alle Kanäle im Audiodatenstrom ab.
IAudioStreamVolume::GetChannelCount Die GetChannelCount-Methode ruft die Anzahl der Kanäle im Audiodatenstrom ab.
IAudioStreamVolume::GetChannelVolume Die GetChannelVolume-Methode ruft die Lautstärke für den angegebenen Kanal im Audiodatenstrom ab.
IAudioStreamVolume::SetAllVolumes Die SetAllVolumes-Methode legt die einzelnen Lautstärken für alle Kanäle im Audiodatenstrom fest.
IAudioStreamVolume::SetChannelVolume Die SetChannelVolume-Methode legt die Lautstärke für den angegebenen Kanal im Audiodatenstrom fest.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	audioclient.h

Weitere Informationen

Kernaudioschnittstellen

IAudioClient::GetService

IChannelAudioVolume-Schnittstelle

ISimpleAudioVolume-Schnittstelle

WASAPI