KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
Die KSPROPERTY_AUDIO_MIX_LEVEL_TABLE-Eigenschaft gibt die Mixebenen für einen Supermixerknoten (KSNODETYPE_SUPERMIX) an. Sie stellt Informationen für alle Eingabe- und Ausgabekanäle bereit.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Optional |
Pin |
Array von KSAUDIO_MIXLEVEL Strukturen |
Der Knoten ist erforderlich, um Unterstützung für KSPROPERTY_TYPE_GET Anforderungen zu implementieren. Die Unterstützung für KSPROPERTY_TYPE_SET Anforderungen ist jedoch optional.
Der Eigenschaftswert (Vorgangsdaten) ist ein Array von KSAUDIO_MIXLEVEL Strukturen, das die Mixebenen für alle M*N-Eingabe-Ausgabepfade in einem Supermixerknoten mit M-Eingabekanälen und N-Ausgabekanälen angibt. Das Array enthält M*N-Elemente:
KSAUDIO_MIXLEVEL MixLevel[M*N];
Die folgende Tabelle zeigt die Zuordnung von Arrayelementen zu den M*N-Eingabe-Ausgabepfaden des Supermixerknotens.
| Array-Element | Input-Output Pfad |
|---|---|
MixLevel[0] |
Eingabekanal 0 bis Ausgabekanal 0 |
MixLevel[1] |
Eingabekanal 0 bis Ausgabekanal 1 |
MixLevel[N-1] |
Eingabekanal 0 zum Ausgabekanal N-1 |
MixLevel[N] |
Eingabekanal 1 bis Ausgabekanal 0 |
MixLevel[N+1] |
Eingabekanal 1 bis Ausgabekanal 1 |
MixLevel[2N-1] |
Eingabekanal 1 bis Ausgabekanal N-1 |
MixLevel[M*N-1] |
Eingabekanal M-1 zum Ausgabekanal N-1 |
Die folgende Abbildung veranschaulicht die Zuordnung von MixLevel-Arrayelementen zu Eingabe-Ausgabepfaden. Der Index des MixLevel-Arrayelements, das jeden Eingabe-Ausgabepfad steuert, wird in eckigen Klammern angezeigt.
Wenn kein Pfad den Eingabekanal i mit dem Ausgabekanal j verbindet, sollte der Filter das Mute-Element des Arrayelements MixLevel[i*N+j] auf TRUE festlegen.
Die Größe des KSAUDIO_MIXLEVEL Arrays wird aus der KSAUDIO_MIXCAP_TABLE-Struktur berechnet, die von KSPROPERTY_AUDIO_MIX_LEVEL_CAPS abgerufen wird. Wenn die Elemente InputChannels und OutputChannels der Struktur die Werte m und n enthalten, ist die Arraygröße
M * N * sizeof(KSAUDIO_MIXLEVEL)
Rückgabewert
Eine KSPROPERTY_AUDIO_MIX_LEVEL_TABLE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.
Hinweise
Mit dem Filter wird eine KSPROPERTY_AUDIO_MIX_LEVEL_TABLE Set-Eigenschaftsanforderung erfolgreich ausgeführt, die einen Wert auf Mischebene (Level member of KSAUDIO_MIXLEVEL) angibt, der außerhalb des Bereichs des Filters liegt, aber den Wert (unbeaufsichtigt) in den unterstützten Bereich klemmt. Bei einer nachfolgenden Anforderung zum Abrufen dieser Eigenschaft gibt der Filter jedoch den tatsächlich verwendeten Wert aus.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |