KSPROPERTY_AUDIO_VOLUMELEVEL

Artigo
06/14/2023

A propriedade KSPROPERTY_AUDIO_VOLUMELEVEL especifica o nível de volume de um canal em um nó de volume (KSNODETYPE_VOLUME).

Tabela de Resumo de Uso

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

O valor da propriedade é do tipo LONG e especifica o nível de volume de um canal em um determinado fluxo. Os valores de nível de volume usam a seguinte escala:

-2147483648 é -infinity decibels (atenuação),

-2147483647 é -32767.99998474 decibéis (atenuação) e

+2147483647 é +32767,99998474 decibéis (ganho).

Observação

O intervalo de decibéis é representado por valores inteiros de -2147483648 a +2147483647, em que essa escala tem uma resolução de 1/65536 decibel.

Se um valor for especificado além do intervalo do filtro, a solicitação para definir essa propriedade ainda será bem-sucedida. Mas o valor real que foi aplicado ao filtro só pode ser determinado por uma chamada Get subsequente para essa propriedade.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_VOLUMELEVEL 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 descritor de propriedade para essa propriedade especifica um número de canal. Se o fluxo que passa pelo nó de volume contiver n canais, os canais serão numerados de 0 a n-1. Para obter mais informações, consulte Expondo nós multicanal.