IAudioVolumeLevel-Schnittstelle (devicetopology.h)

  • Artikel

Die IAudioVolumeLevel-Schnittstelle bietet Zugriff auf eine Hardware-Lautstärkeregelung. Der Client ruft einen Verweis auf die IAudioVolumeLevel-Schnittstelle einer Untereinheit ab, indem er die IPart::Activate-Methode aufruft, wobei der Parameter refiid auf REFIID IID_IAudioVolumeLevel festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioVolumeLevel-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Steuerung auf Hardwarevolumeebene darstellt, unterstützt diese Schnittstelle.

Die IAudioVolumeLevel-Schnittstelle bietet Kanalsteuerungen zum Festlegen und Abrufen der Verstärkungs- oder Dämpfungsstufen im Audiodatenstrom. Wenn eine Hardwaresteuerung auf Lautstärkeebene die Kanäle im Audiodatenstrom nur mindernen kann, beträgt die maximale Lautstärke für jeden Kanal 0 dB. Wenn ein Lautstärkeregler eine Verstärkung (Verstärkung) bereitstellen kann, ist die maximale Lautstärke größer als 0 dB.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (Windows Driver Model, WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IAudioVolumeLevel-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_VOLUMELEVEL-Eigenschaft einer Untereinheit, die über den GUID-Untertypwert KSNODETYPE_VOLUME verfügt. Um die Untertyp-GUID einer Untereinheit abzurufen, rufen Sie die IPart::GetSubType-Methode auf. Weitere Informationen zu KS-Eigenschaften und KS-Knotentypen finden Sie in der Dokumentation zu Windows DDK.

Vererbung

Die IAudioVolumeLevel-Schnittstelle erbt von der IPerChannelDbLevel-Schnittstelle.

Anforderungen

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

Weitere Informationen

Kernaudioschnittstellen

DeviceTopology-API

IPart::Activate

IPerChannelDbLevel-Schnittstelle