KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
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) |
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.
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.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |