KSPROPERTY_AUDIO_EQ_LEVEL
Die KSPROPERTY_AUDIO_EQ_LEVEL-Eigenschaft gibt die Entzerrungsebenen für eine Entzerrungstabelle an, die Einträge für n Frequenzbänder enthält. Dies ist eine Eigenschaft eines Kanals in einem EQ-Knoten (KSNODETYPE_EQUALIZER).
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Ja |
Filter |
LONG-Array |
Der Eigenschaftswert (Vorgangsdaten) ist ein Array von LONG-Elementen:
LONG Level[N];
Wenn die Entzerrungstabelle des Kanals Einträge für N-Frequenzbänder enthält, enthält das Array N-Elemente, und jedes Element gibt die Ebene für eines der Bänder in der Entzerrungstabelle an. Die Zuweisung von Bändern zu Arrayelementen ist in der folgenden Tabelle dargestellt.
Beschreibungsebene des Arrayelements[0]
Ebene für Band 0.
Ebene[1]
Ebene für Band 1.
...
Level[N-1]
Ebene für Band N-1.
Ebenenwerte verwenden die folgende Skalierung:
-2147483648 ist -Unendliche Dezibel (Dämpfung),
-2147483647 ist -32767,99998474 Dezibel (Dämpfung), und
+2147483647 ist +32767,99998474 Dezibel (Verstärkung).
Ein Dezibelbereich, der durch ganzzahlige Werte 2147483648 bis +2147483647 dargestellt wird, wobei
Diese Skala hat eine Auflösung von 1/65536 Dezibel.
Rückgabewert
Eine KSPROPERTY_AUDIO_EQ_LEVEL-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.
Bemerkungen
Der Filter ist erfolgreich für eine KSPROPERTY_AUDIO_EQ_LEVEL Set-Property-Anforderung, die einen Wert angibt, der außerhalb des Bereichs des Filters liegt, aber den Wert in den unterstützten Bereich einklammert. In einer nachfolgenden Anforderung zum Abrufen dieser Eigenschaft wird jedoch der tatsächlich verwendete Wert ausgegeben.
Die Anzahl der Entzerrungsbänder kann bestimmt werden, indem Zuerst eine KSPROPERTY_AUDIO_NUM_EQ_BANDS-Anforderung übermittelt wird.
Die mittleren Frequenzen der Entzerrungsbänder werden durch die KSPROPERTY_AUDIO_EQ_BANDS-Eigenschaft angegeben.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |