Compartilhar via


KSPROPERTY_AUDIO_PEAKMETER

A propriedade KSPROPERTY_AUDIO_PEAKMETER recupera 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.

Importante

KSPROPERTY_AUDIO_PEAKMETER propriedade é depreciada e não deve ser usada. Em vez disso , use KSPROPERTY_AUDIO_PEAKMETER2 .

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

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 de IOCTL_KS_PROPERTY para a propriedade KSPROPERTY_AUDIO_PEAKMETER em PASSIVE_LEVEL IRQL.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_PEAKMETER

KSPROPERTY_AUDIO_PEAKMETER2