KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
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 |
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.
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.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |