Share via

IAudioTreble-Schnittstelle (devicetopology.h)

  • Artikel

Die IAudioTreble-Schnittstelle ermöglicht den Zugriff auf ein Hardwaresteuerelement auf Dreifachebene. Der Client ruft einen Verweis auf die IAudioTreble-Schnittstelle einer Untereinheit ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIID IID_IAudioTreble festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioTreble-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Hardwarefunktion zum Steuern der Höhenfrequenzen in jedem Kanal darstellt, unterstützt diese Schnittstelle.

Die IAudioTreble-Schnittstelle bietet Kanalsteuerungen zum Festlegen und Abrufen der Verstärkungs- oder Dämpfungsstufe der Höhenfrequenzen im Audiostream. Wenn ein Hardwaresteuerelement auf dreifacher Ebene nur die Kanäle im Audiostream abschwächen kann, beträgt der maximale Höhenpegel für einen Kanal 0 dB. Wenn ein Steuerelement auf Höhenebene Verstärkung (Verstärkung) bieten kann, ist der maximale Höhenpegel größer als 0 dB.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IAudioTreble-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_TREBLE-Eigenschaft einer Untereinheit, die über den GUID-Wert des Untertyps KSNODETYPE_TONE 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 Windows DDK-Dokumentation.

Vererbung

Die IAudioTreble-Schnittstelle erbt von der IPerChannelDbLevel-Schnittstelle.

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

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate

IPerChannelDbLevel-Schnittstelle