KSPROPERTY_AUDIO_EQ_LEVEL
A propriedade KSPROPERTY_AUDIO_EQ_LEVEL especifica os níveis de equalização de uma tabela de equalização que contém entradas para n faixas de frequência. Essa é uma propriedade de um canal em um nó EQ (KSNODETYPE_EQUALIZER).
Tabela de Resumo de Uso
| Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Sim |
Sim |
Filtrar |
Matriz LONG |
O valor da propriedade (dados de operação) é uma matriz de elementos LONG:
LONG Level[N];
Se a tabela de equalização do canal contiver entradas para N faixas de frequência, a matriz conterá N elementos e cada elemento especificará o nível de uma das faixas na tabela de equalização. A atribuição de bandas a elementos de matriz é mostrada na tabela a seguir.
Nível de descrição do elemento array[0]
Nível para a banda 0.
Level[1]
Nível para a banda 1.
...
Level[N-1]
Nível para a banda N-1.
Os valores de nível usam a seguinte escala:
-2147483648 é -Infinity decibels (atenuação),
-2147483647 é -32767.99998474 decibéis (atenuação) e
+2147483647 é +32767,99998474 decibéis (ganho).
Um intervalo de decibéis representado por valores inteiros -2147483648 para +2147483647, em que
Essa escala tem uma resolução de 1/65536 decibel.
Valor retornado
Uma solicitação de propriedade KSPROPERTY_AUDIO_EQ_LEVEL retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.
Comentários
O filtro terá êxito em um KSPROPERTY_AUDIO_EQ_LEVEL solicitação set-property que especifica um valor que está além do intervalo do filtro, mas que fixará o valor ao intervalo com suporte. Em uma solicitação subsequente para obter essa propriedade, no entanto, ela produzirá o valor real usado.
O número de faixas de equalização pode ser determinado primeiro enviando uma solicitação KSPROPERTY_AUDIO_NUM_EQ_BANDS .
As frequências central das faixas de equalização são especificadas pela propriedade KSPROPERTY_AUDIO_EQ_BANDS .
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |