KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

Artículo
03/08/2023

La propiedad KSPROPERTY_AUDIO_MIX_LEVEL_TABLE especifica los niveles de combinación de un nodo supermezclador (KSNODETYPE_SUPERMIX). Proporciona información para todos los canales de entrada y salida.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Opcionales	Anclar	KSNODEPROPERTY	Matriz de estructuras de KSAUDIO_MIXLEVEL

El nodo es necesario para implementar la compatibilidad con las solicitudes de KSPROPERTY_TYPE_GET. Sin embargo, la compatibilidad con las solicitudes de KSPROPERTY_TYPE_SET es opcional.

El valor de propiedad (datos de operación) es una matriz de estructuras de KSAUDIO_MIXLEVEL que especifica los niveles de combinación para todas las rutas de acceso de salida de entrada M*N en un nodo de supermezclador con canales de entrada M y N canales de salida. La matriz contiene elementos M*N:

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

En la tabla siguiente se muestra la asignación de elementos de matriz a las rutas de acceso de salida de entrada M*N del nodo supermezclador.

Elemento Array	ruta de acceso de Input-Output
MixLevel[0]	Canal de entrada 0 al canal de salida 0
MixLevel[1]	Canal de entrada 0 al canal de salida 1
MixLevel[N-1]	Canal de entrada 0 al canal de salida N-1
MixLevel[N]	Canal de entrada 1 al canal de salida 0
MixLevel[N+1]	Canal de entrada 1 al canal de salida 1
MixLevel[2N-1]	Canal de entrada 1 al canal de salida N-1
MixLevel[M*N-1]	Canal de entrada M-1 al canal de salida N-1

En la ilustración siguiente se muestra la asignación de elementos de matriz MixLevel a rutas de acceso de entrada y salida. El índice del elemento de matriz MixLevel que controla cada ruta de acceso de entrada y salida se muestra entre corchetes.

Diagrama que ilustra la asignación de elementos de matriz MixLevel de un nodo supermezclador a rutas de acceso de entrada y salida.

Si ninguna ruta de acceso conecta el canal de entrada i al canal de salida j, el filtro debe establecer el miembro Silenciar del elemento de matriz MixLevel[i*N+j] en TRUE.

El tamaño de la matriz de KSAUDIO_MIXLEVEL se calcula a partir de la estructura de KSAUDIO_MIXCAP_TABLE que se recupera de KSPROPERTY_AUDIO_MIX_LEVEL_CAPS. Si los miembros InputChannels y OutputChannels de la estructura contienen los valores m y n, el tamaño de la matriz es

M * N * sizeof(KSAUDIO_MIXLEVEL)

Valor devuelto

Una solicitud de propiedad KSPROPERTY_AUDIO_MIX_LEVEL_TABLE devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Comentarios

El filtro se realizará correctamente una solicitud de KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property que especifique un valor de nivel de combinación (miembro level de KSAUDIO_MIXLEVEL) que esté fuera del intervalo del filtro, pero que sujetará (silenciosamente) el valor al intervalo admitido. Sin embargo, en una solicitud posterior para obtener esta propiedad, el filtro generará el valor real usado.