Compartilhar via


KSPROPERTY_AUDIO_EQ_BANDS

A propriedade KSPROPERTY_AUDIO_EQ_BANDS especifica o conjunto de faixas de frequência de uma tabela de equalização. Essa é uma propriedade get-only 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

Não

Filtrar

KSNODEPROPERTY_AUDIO_CHANNEL

Matriz ULONG

O valor da propriedade (dados de operação) é uma matriz de elementos ULONG:

  ULONG  CenterFreqVal[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 de matriz especificará a frequência central da banda correspondente. O driver de miniporta grava em cada elemento um valor de frequência inteiro expresso em hertz (Hz). A atribuição de faixas de equalização para elementos de matriz é mostrada na tabela a seguir.

Array Element Description CenterFreqVal[0]

A frequência central (em Hz) para a faixa de equalização 0.

CenterFreqVal[1]

A frequência central (em Hz) para a faixa de equalização 1.

...

CenterFreqVal[N-1]

A frequência central (em Hz) para a faixa de equalização N-1.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_EQ_BANDS 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 número de faixas de equalização pode ser determinado enviando primeiro uma solicitação de KSPROPERTY_AUDIO_NUM_EQ_BANDS .

Os níveis de equalização para as faixas de frequência são especificados pela propriedade KSPROPERTY_AUDIO_EQ_LEVEL .

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_EQUALIZER

KSPROPERTY_AUDIO_NUM_EQ_BANDS

KSPROPERTY_AUDIO_EQ_LEVEL