KSPROPERTY_AUDIO_VOLUMELEVEL
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 |
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.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |
Confira também
Personalizando configurações de volume de áudio padrão