IAudioPeakMeter-Schnittstelle (devicetopology.h)
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 |