KSPROPERTY_AUDIO_PEAKMETER2

Windows 8 introduziu a propriedade KSPROPERTY_AUDIO_PEAKMETER2 que relata o nível máximo de sinal de áudio que ocorreu em um nó de pico (KSNODETYPE_PEAKMETER) desde a última vez em que o nó de pico foi redefinido.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Nó por meio da instância de Filtro ou Fixação	KSNODEPROPERTY_AUDIO_CHANNEL	LONG

O valor da propriedade (dados de operação) é do tipo LONG e especifica o valor de exemplo de pico no nó. Se o valor de pico for negativo, seu valor absoluto será usado.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_PEAKMETER2 retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código. A tabela a seguir mostra um possível erro status código.

Código de status	Significado
STATUS_NOT_IMPLEMENTED	O filtro KS não pode retornar o valor atual do picometer.

Comentários

A propriedade KSPROPERTY_AUDIO_PEAKMETER2 é quase idêntica à propriedade KSPROPERTY_AUDIO_PEAKMETER . A propriedade KSPROPERTY_AUDIO_PEAKMETER2 foi introduzida com Windows 8 para fornecer maior medição de hardware de uma topologia de pino. A propriedade KSPROPERTY_AUDIO_PEAKMETER herdada foi preterida e não deve mais ser usada.

SignedMinimum deve ser definido como LONG_MIN (em vez de 0x8000) e SignedMaximum deve ser definido como LONG_MAX (em vez de 0x7fff). Além disso, observe que os valores de medidor de pico são relativos a essa escala e a escala é linear em amplitude.

Portanto, se, por exemplo, você tiver uma forma de onda com picos negativos e positivos em -1 e +1 respectivamente (em uma escala que vai de -1 a +1), um valor de medidor de pico de LONG_MAX relatará com precisão o valor máximo da forma de onda para uma determinada janela de tempo. Por outro lado, um valor de medidor de pico de zero (0) deve ser usado para relatar o silêncio, em que todos os valores da forma de onda são zero. Mas no caso de uma forma de onda cujos valores de pico estão entre zero (0) e LONG_MAX, os valores de forma de onda relatados seriam reduzidos linearmente dos originais.

Portanto, no caso da forma de onda que oscila entre -0,5 e +0,5 (em uma escala que vai de -1 a +1), o valor do medidor de pico deve ser definido como LONG_MAX/2.

Um filtro de áudio KS manipula essa solicitação de propriedade de forma síncrona. Se a solicitação for bem-sucedida, ela redefinirá o picometer, que inicializa o valor de pico acumulado como zero. Se a solicitação não for bem-sucedida, o picometer não será alterado.

O sistema envia uma solicitação IOCTL_KS_PROPERTY para a propriedade KSPROPERTY_AUDIO_PEAKMETER2 em PASSIVE_LEVEL IRQL.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_PEAKMETER

KSPROPERTY_AUDIO_PEAKMETER