IAudioLoudness-Schnittstelle (devicetopology.h)

Die IAudioLoudness-Schnittstelle bietet Zugriff auf ein "Loudness"-Kompensationssteuerelement. Der Client ruft einen Verweis auf die IAudioLoudness-Schnittstelle einer Untereinheit ab, indem er die IPart::Activate-Methode aufruft, wobei der Parameter refiid auf REFIID IID_IAudioLoudness festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioLoudness-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Hardwarelautheitssteuerungsfunktion darstellt, unterstützt diese Schnittstelle.

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 IAudioLoudness-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_LOUDNESS-Eigenschaft einer Untereinheit mit dem GUID-Untertypwert KSNODETYPE_LOUDNESS. 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 IAudioLoudness-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioLoudness verfügt auch über folgende Arten von Membern:

Methoden

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

IAudioLoudness::GetEnabled Die GetEnabled-Methode ruft den aktuellen Zustand (aktiviert oder deaktiviert) des Lautheitssteuerelements ab.
IAudioLoudness::SetEnabled Die SetEnabled-Methode aktiviert oder deaktiviert die Lautstärkesteuerung.

Anforderungen

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