KSPROPERTY_AUDIOENGINE_VOLUMELEVEL
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 |
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.
Requisitos
Versão |
Windows 8 |
Cabeçalho |
Ksmedia.h |