KSPROPERTY_AUDIO_PEAKMETER2
Windows 8 wurde die eigenschaft KSPROPERTY_AUDIO_PEAKMETER2 eingeführt, die den maximalen Audiosignalpegel meldet, der seit dem letzten Zurücksetzen des peakmeter-Knotens an einem Peakmeter-Knoten (KSNODETYPE_PEAKMETER) aufgetreten ist.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Knoten über Filter oder anheften instance |
KSNODEPROPERTY_AUDIO_CHANNEL | LONG |
Der Eigenschaftswert (Vorgangsdaten) ist vom Typ LONG und gibt den Spitzenwert des Beispiels auf dem Knoten an. Wenn der Spitzenwert negativ ist, wird sein absoluter Wert verwendet.
Rückgabewert
Eine KSPROPERTY_AUDIO_PEAKMETER2-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück. Die folgende Tabelle zeigt einen möglichen Fehler status Code.
| Statuscode | Bedeutung |
|---|---|
STATUS_NOT_IMPLEMENTED |
Der KS-Filter kann den aktuellen Wert des Peakmeters nicht zurückgeben. |
Bemerkungen
Die KSPROPERTY_AUDIO_PEAKMETER2-Eigenschaft ist fast identisch mit der eigenschaft KSPROPERTY_AUDIO_PEAKMETER . Die eigenschaft KSPROPERTY_AUDIO_PEAKMETER2 wurde mit Windows 8 eingeführt, um eine verbesserte Hardwaremessung einer Pintopologie bereitzustellen. Die Legacy-KSPROPERTY_AUDIO_PEAKMETER-Eigenschaft ist veraltet und sollte nicht mehr verwendet werden.
SignedMinimum muss auf LONG_MIN (anstelle von 0x8000) festgelegt werden, und SignedMaximum muss auf LONG_MAX (anstelle von 0x7fff) festgelegt werden. Beachten Sie außerdem, dass Spitzenzählerwerte relativ zu dieser Skala sind und die Skala linear in der Amplitude ist.
Wenn Sie also beispielsweise eine Wellenform mit negativen und positiven Spitzen bei -1 bzw. +1 haben (auf einer Skala, die von -1 bis +1 reicht), dann meldet ein Spitzenzählerwert von LONG_MAX den maximalen Wellenformwert für ein bestimmtes Zeitfenster genau. Umgekehrt sollte ein Spitzenzählerwert von 0 (0) verwendet werden, um Stille zu melden, wobei alle Werte der Wellenform null sind. Im Fall einer Wellenform, deren Spitzenwerte zwischen Null (0) und LONG_MAX liegen, würden die gemeldeten Wellenformwerte gegenüber den Originalen linear reduziert.
Bei der Wellenform, die zwischen -0,5 und +0,5 schwankt (auf einer Skala, die von -1 bis +1 reicht), muss daher der Spitzenzählerwert auf LONG_MAX/2 festgelegt werden.
Ein KS-Audiofilter verarbeitet diese Eigenschaftsanforderung synchron. Wenn die Anforderung erfolgreich ist, wird der Peakmeter zurückgesetzt, wodurch der akkumulierte Spitzenwert auf 0 (null) initialisiert wird. Wenn die Anforderung nicht erfolgreich ist, wird der Peakmeter nicht geändert.
Das System sendet eine IOCTL_KS_PROPERTY Anforderung für die eigenschaft KSPROPERTY_AUDIO_PEAKMETER2 am IRQL-PASSIVE_LEVEL.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |