KSNODETYPE_PEAKMETER

Der KSNODETYPE_PEAKMETER-Knoten stellt einen Hardwarespitzenmesser dar. Ein KS-Peakmeterknoten verfügt über einen Eingabe- und einen Ausgabestift, und die beiden Pins haben das gleiche Datenformat.

Ein KS-Peakmeter protokolliert intern den maximalen Wert des Audiosignals seit dem letzten Zurücksetzen des Peakmeters auf 0. Das Peakmeter setzt sich nach einer IOCTL_KS_PROPERTY Anforderung zum Abrufen einer KSPROPERTY_AUDIO_PEAKMETER2-Eigenschaft automatisch auf null zurück.

Ein Peakmeter erfordert Hardwareunterstützung. Ein Softwarespitzenmesser ist nicht möglich, und dies liegt daran, dass der Adaptertreiber keinen Zugriff auf Signale hat, die im Line-In, Mikrofon oder anderen Eingängen vorhanden sind, die mit dem Wiedergabekanal gemischt werden.

Microsoft empfiehlt, einen Peakmeterknoten zum letzten Knoten zu machen, über den ein Stream innerhalb eines Filters verläuft. In einem Renderstream verbindet ein Audioadapter normalerweise einen Peakmeterknoten nach einer master Ausgabe KSNODETYPE_MUTE Knotens oder einem KSNODETYPE_VOLUME Knoten. Der gleiche Ansatz gilt für einen Erfassungsstream oder andere Datenströme, für die der Filter einen Peakmeterknoten enthält.

Ein Audioadapter sollte einen Peakmeterknoten KSAUDFNAME_PEAKMETER benennen.

Ein Peakmeterknoten sollte einen Eigenschaftenhandler für die Eigenschaftenflags (siehe KSPROPERTY) bereitstellen, die in der folgenden Tabelle angezeigt werden.

Flagname	Bedeutung
KSPROPERTY_TYPE_GET	Gibt den aktuellen Wert des Hardwarespitzenmessers zurück.
KSPROPERTY_TYPE_BASICSUPPORT	Für KSPROPERTY_AUDIO_PEAKMETER: Gibt einen Datenbereich von 0x8000 bis 0x7fff zurück, d. h. den Datenbereich von 16-Bit-Digitalaudio. Die oberen 16 Bits müssen auf 0 festgelegt werden, damit das Betriebssystem einen positiven Wert erhält. Beachten Sie, dass KSPROPERTY_AUDIO_PEAKMETER veraltet ist und stattdessen KSPROPERTY_AUDIO_PEAKMETER2 verwendet werden sollten. Für KSPROPERTY_AUDIO_PEAKMETER2: Gibt einen Datenbereich mit LONG_MIN zurück, die LONG_MAX.

Der Eigenschaftenhandler sollte Eingabeparameter und Links- und Rechtskanalinformationen überprüfen.

Ein Peakmeterknoten sollte auch die Eigenschaften in der folgenden Tabelle unterstützen.

Eigenschaftenname	Beschreibung
KSPROPERTY_AUDIO_PEAKMETER2	Stellt das Peakmeter-Steuerelement dar.
KSPROPERTY_AUDIO_CPU_RESOURCES	Gibt an, ob die Funktionalität des angegebenen Knotens die Host-CPU nutzt.