KSPROPERTY_AUDIO_EQ_LEVEL

Artigo
06/14/2023

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	KSNODEPROPERTY_AUDIO_CHANNEL	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 .