Поделиться через


KSPROPERTY_AUDIO_VOLUMELEVEL

Свойство KSPROPERTY_AUDIO_VOLUMELEVEL указывает уровень громкости канала в узле тома (KSNODETYPE_VOLUME).

Сводная таблица использования

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Да

Да

Узел с помощью фильтра или закрепления экземпляра

KSNODEPROPERTY_AUDIO_CHANNEL

LONG

Значение свойства имеет тип LONG и указывает уровень громкости канала в заданном потоке. Для значений уровня тома используется следующая шкала:

-2147483648 является децибелами -бесконечности (затухание),

-2147483647 равно -32767,99998474 децибел (затухание) и

+2147483647 равно +32767.99998474 децибел (выигрыш).

Примечание

 Диапазон децибела представлен целыми значениями от -2147483648 до +2147483647, где эта шкала имеет разрешение 1/65536 децибел.

Если значение указано за пределами диапазона фильтра, запрос на настройку этого свойства будет по-прежнему успешным. Но фактическое значение, примененное к фильтру, может быть определено только последующим вызовом Get этого свойства.

Возвращаемое значение

Запрос свойства KSPROPERTY_AUDIO_VOLUMELEVEL возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.

Комментарии

Дескриптор свойства для этого свойства указывает номер канала. Если поток, проходящий через узел тома, содержит n каналов, то каналы нумеруются от 0 до n-1. Дополнительные сведения см. в разделе Предоставление многоканальных узлов.

Требования

Заголовок

Ksmedia.h (включая Ksmedia.h)

См. также

Настройка параметров громкости звука по умолчанию

Параметры громкости звука по умолчанию

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_VOLUME