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) |