IAudioPeakMeter-Schnittstelle (devicetopology.h)

  • Artikel

Die IAudioPeakMeter-Schnittstelle ermöglicht den Zugriff auf eine Hardware-Peak-Meter-Steuerung. Der Client ruft einen Verweis auf die IAudioPeakMeter-Schnittstelle einer Untereinheit ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIID IID_IAudioPeakMeter festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioPeakMeter-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das einen Hardwarespitzenzähler darstellt, unterstützt diese Schnittstelle.

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 IAudioPeakMeter-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_PEAKMETER-Eigenschaft einer Untereinheit, die den Untertyp-GUID-Wert KSNODETYPE_PEAKMETER hat. 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 IAudioPeakMeter-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioPeakMeter verfügt auch über folgende Arten von Membern:

Methoden

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

 
IAudioPeakMeter::GetChannelCount

Die GetChannelCount-Methode ruft die Anzahl der Kanäle im Audiostream ab. (IAudioPeakMeter.GetChannelCount)
IAudioPeakMeter::GetLevel

Die GetLevel-Methode ruft die Spitzenebene ab, die der Spitzenzähler für den angegebenen Kanal aufgezeichnet hat, da die Spitzenebene für diesen Kanal zuvor gelesen wurde.

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

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate