Partilhar via

KSNODETYPE_PEAKMETER

  • Artigo

O nó KSNODETYPE_PEAKMETER representa um picometer de hardware. Um nó de picometer KS tem um pino de entrada e um pino de saída, e os dois pinos compartilham o mesmo formato de dados.

Um picometr KS registra internamente o valor máximo do sinal de áudio desde a última vez em que o picometer foi redefinido para zero. O picometer se redefine automaticamente para zero após uma solicitação de IOCTL_KS_PROPERTY para obter uma propriedade KSPROPERTY_AUDIO_PEAKMETER2 .

Um picometer requer suporte de hardware. Um picometer de software não é viável e isso ocorre porque o driver do adaptador não tem acesso a sinais presentes na entrada de linha, microfone ou outras entradas misturadas com o canal de reprodução.

A Microsoft recomenda tornar um nó de picometer o nó final pelo qual um fluxo passa dentro de um filtro. Em um fluxo de renderização, um adaptador de áudio geralmente conecta um nó de picometer após uma saída de master KSNODETYPE_MUTE nó ou um nó KSNODETYPE_VOLUME. A mesma abordagem se aplica a um fluxo de captura ou a qualquer outro fluxo para o qual o filtro incorpora um nó de picometer.

Um adaptador de áudio deve nomear um nó de pico KSAUDFNAME_PEAKMETER.

Um nó de picometer deve fornecer um manipulador de propriedades para os sinalizadores de propriedade (consulte KSPROPERTY) que aparecem na tabela a seguir.

Nome do Sinalizador Significado

KSPROPERTY_TYPE_GET

Retorna o valor atual do pico de hardware.

KSPROPERTY_TYPE_BASICSUPPORT

Por KSPROPERTY_AUDIO_PEAKMETER – retorna um intervalo de dados de 0x8000 para 0x7fff, que é o intervalo de dados de áudio digital de 16 bits. Os 16 bits superiores devem ser definidos como zero, para permitir que o sistema operacional receba um valor positivo. Observe que KSPROPERTY_AUDIO_PEAKMETER foi preterido e KSPROPERTY_AUDIO_PEAKMETER2 deve ser usado.

Para KSPROPERTY_AUDIO_PEAKMETER2 – retorna um intervalo de dados de LONG_MIN para LONG_MAX.

O manipulador de propriedades deve verificar os parâmetros de entrada e as informações do canal esquerdo e direito.

Um nó de picometer também deve dar suporte às propriedades na tabela a seguir.

Nome da propriedade Descrição

KSPROPERTY_AUDIO_PEAKMETER2

Representa o controle de pico.

KSPROPERTY_AUDIO_CPU_RESOURCES

Indica se a funcionalidade do nó especificado usa a CPU do host.