IAudioMidrange-Schnittstelle (devicetopology.h)
Die IAudioMidrange-Schnittstelle bietet Zugriff auf ein Hardware-Midrange-Level-Steuerelement. Der Client ruft einen Verweis auf die IAudioMidrange-Schnittstelle einer Untereinheit ab, indem er die IPart::Activate-Methode aufruft, wobei der Parameter refiid auf REFIID IID_IAudioMidrange festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioMidrange-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das eine Hardwarefunktion zum Steuern der Mittleren Frequenzen in jedem Kanal darstellt, unterstützt diese Schnittstelle.
Die IAudioMidrange-Schnittstelle bietet Kanalsteuerungen zum Festlegen und Abrufen der Verstärkungs- oder Dämpfungsstufe der Midrangefrequenzen im Audiostream. Wenn ein Hardwaresteuerelement auf Mittlerer Ebene nur die Kanäle im Audiostream abschwächen kann, beträgt die maximale Mittelbereichsebene für einen Kanal 0 dB. Wenn ein Steuerelement auf Mittlerer Ebene Verstärkung (Verstärkung) bieten kann, ist die maximale Mittelbereichsebene 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 IAudioMidrange-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_MID-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 IAudioMidrange-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 |