KSPROPERTY_AUDIO_EQ_LEVEL
La propiedad KSPROPERTY_AUDIO_EQ_LEVEL especifica los niveles de ecualización para una tabla de ecualización que contiene entradas para n bandas de frecuencia. Se trata de una propiedad de un canal en un nodo de EQ (KSNODETYPE_EQUALIZER).
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
Sí |
Filtrar |
Matriz LONG |
El valor de propiedad (datos de operación) es una matriz de elementos LONG:
LONG Level[N];
Si la tabla de ecualización del canal contiene entradas para N bandas de frecuencia, la matriz contiene N elementos y cada elemento especifica el nivel de una de las bandas de la tabla de ecualización. La asignación de bandas a elementos de matriz se muestra en la tabla siguiente.
Nivel de descripción del elemento Array[0]
Nivel de banda 0.
Nivel[1]
Nivel de banda 1.
...
Level[N-1]
Nivel de banda N-1.
Los valores de nivel usan la escala siguiente:
-2147483648 es -Infinity decibels (atenuación),
-2147483647 es -32767.99998474 decibelios (atenuación) y
+2147483647 es +32767.99998474 decibels (ganancia).
Intervalo decibeles representado por valores enteros -2147483648 a +2147483647, donde
Esta escala tiene una resolución de 1/65536 decibel.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_AUDIO_EQ_LEVEL devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.
Observaciones
El filtro se realizará correctamente una solicitud de KSPROPERTY_AUDIO_EQ_LEVEL set-property que especifique un valor que esté fuera del intervalo del filtro, pero que restringirá el valor al intervalo admitido. Sin embargo, en una solicitud posterior para obtener esta propiedad, generará el valor real usado.
El número de bandas de ecualización se puede determinar enviando primero una solicitud de KSPROPERTY_AUDIO_NUM_EQ_BANDS .
Las frecuencias centrales de las bandas de ecualización se especifican mediante la propiedad KSPROPERTY_AUDIO_EQ_BANDS .
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |