KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

Articolo
11/14/2023

La proprietà KSPROPERTY_AUDIO_MIX_LEVEL_TABLE specifica i livelli di combinazione per un nodo supermixer (KSNODETYPE_SUPERMIX). Fornisce informazioni per tutti i canali di input e output.

Tabella riepilogo utilizzo

Get	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo di valore della proprietà
sì	Facoltativo	Aggiungi (Blocca)	KSNODEPROPERTY	Matrice di strutture KSAUDIO_MIXLEVEL

Il nodo è necessario per implementare il supporto per le richieste di KSPROPERTY_TYPE_GET. Tuttavia, il supporto per le richieste di KSPROPERTY_TYPE_SET è facoltativo.

Il valore della proprietà (dati operazione) è una matrice di strutture KSAUDIO_MIXLEVEL che specifica i livelli di combinazione per tutti i percorsi di input M*N in un nodo supermixer con canali di input M e N. La matrice contiene elementi M*N:

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

Nella tabella seguente viene illustrato il mapping degli elementi della matrice ai percorsi M*N del nodo supermixer.

Elemento Array	percorso Input-Output
MixLevel[0]	Canale di input 0 per il canale di output 0
MixLevel[1]	Canale di input 0 al canale di output 1
MixLevel[N-1]	Canale di input 0 per il canale di output N-1
MixLevel[N]	Canale di input 1 per il canale di output 0
MixLevel[N+1]	Canale di input 1 per il canale di output 1
MixLevel[2N-1]	Canale di input 1 per il canale di output N-1
MixLevel[M*N-1]	Canale di input M-1 per l'output del canale N-1

Nella figura seguente viene illustrato il mapping degli elementi della matrice MixLevel ai percorsi di output di input. L'indice dell'elemento matrice MixLevel che controlla ogni percorso di output di input viene visualizzato tra parentesi quadre.

Diagramma che illustra il mapping degli elementi della matrice MixLevel di un nodo supermixer ai percorsi di output di input.

Se nessun percorso connette il canale di input i al canale di output j, il filtro deve impostare il membro Mute dell'elemento array MixLevel[i*N+j] su TRUE.

Le dimensioni della matrice di KSAUDIO_MIXLEVEL vengono calcolate dalla struttura KSAUDIO_MIXCAP_TABLE recuperata dall'KSPROPERTY_AUDIO_MIX_LEVEL_CAPS. Se i membri InputChannels e OutputChannels della struttura contengono i valori m e n, la dimensione della matrice è

M * N * sizeof(KSAUDIO_MIXLEVEL)

Valore restituito

Una richiesta di proprietà KSPROPERTY_AUDIO_MIX_LEVEL_TABLE restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.

Commenti

Il filtro avrà esito positivo su una richiesta di KSPROPERTY_AUDIO_MIX_LEVEL_TABLE proprietà set che specifica un valore a livello di combinazione (membro di livello di KSAUDIO_MIXLEVEL) oltre l'intervallo del filtro, ma bloccherà in modo invisibile il valore all'intervallo supportato. In una richiesta successiva per ottenere questa proprietà, tuttavia, il filtro restituirà il valore effettivo usato.