KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

Artigo
06/15/2023

A propriedade KSPROPERTY_AUDIOENGINE_VOLUMELEVEL especifica o nível de volume de um canal em um determinado fluxo.

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 fixação	KSNODEPROPERTY_AUDIO_CHANNEL	LONG (para obter solicitação) e KSAUDIOENGINE_VOLUMELEVEL (para uma solicitação Set).

Para uma solicitação Get, 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 e podem ser limitados pelos valores mínimo e máximo fornecidos na resposta de Suporte Básico para esta propriedade:

-2147483648 (0x80000000 em hexadecimal ou LONG_MIN) é -Decibéis infinitos (atenuação),

-2147483647 (0x80000001 em hexadecimal ou LONG_MIN + 1) é -32767.99998474 decibéis (atenuação) e

+2147483647 (0x7FFFFFFF em hexadecimal ou LONG_MAX) é +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.

Para uma solicitação Set, o valor da propriedade é do tipo KSAUDIOENGINE_VOLUMELEVEL e especifica o nível de volume desejado de um canal em um determinado fluxo, bem como um tipo de curva e duração da curva a serem aplicados à medida que o nível de volume é definido. 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

A solicitação de propriedade KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS 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 KSPROPERTY_AUDIOENGINE_VOLUMELEVEL especifica um número de canal. Se o fluxo que passa pelo nó do mecanismo de áudio contiver n canais, os canais serão numerados de 0 a 1. Observe também que um valor de canal de 0xFFFFFFFF indica que a solicitação se aplica a todos os canais. Se uma solicitação de propriedade for feita enquanto o fluxo não estiver em um estado em execução, o nível de volume será imediatamente definido como o nível solicitado. Se o fluxo deixar o estado de execução enquanto uma rampa de nível de volume estiver em andamento, o nível de volume do fluxo será imediatamente definido como o nível de destino do fade atual. Se uma nova solicitação de propriedade for feita enquanto uma rampa de nível de volume existente estiver em andamento, a nova solicitação de rampa deverá começar a partir do nível de volume atual - o nível que o volume atingiu quando a nova solicitação chegou.