KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

  • Статья

Свойство KSPROPERTY_AUDIOENGINE_VOLUMELEVEL указывает уровень громкости канала в заданном потоке.

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

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

Да

Да

Узел через экземпляр pin

KSNODEPROPERTY_AUDIO_CHANNEL

LONG (для запроса Get) и KSAUDIOENGINE_VOLUMELEVEL (для запроса Set).

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

-2147483648 (0x80000000 в шестнадцатеричном формате или LONG_MIN) имеет значение -Infinity decibels (attenuation),

-2147483647 (0x80000001 в шестнадцатеричном формате или LONG_MIN + 1) равно -32767,99998474 децибел (затухание) и

+2147483647 (0x7FFFFFFF в шестнадцатеричном формате или LONG_MAX) равно +32767,99998474 децибела (коэффициент увеличения).

Примечание

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

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

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

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

Комментарии

Дескриптор свойства для KSPROPERTY_AUDIOENGINE_VOLUMELEVEL задает номер канала. Если поток, проходящий через узел обработчика звука, содержит n каналов, каналы нумеруются от 0 до n-1. Также обратите внимание, что значение канала 0xFFFFFFFF указывает, что запрос применяется ко всем каналам. Если запрос свойства выполняется, пока поток не находится в состоянии выполнения, уровень тома немедленно устанавливается на запрошенный уровень. Если поток выходит из состояния выполнения, пока выполняется пандус уровня тома, уровень громкости потока немедленно устанавливается на целевой уровень текущего затухания. Если запрос на новое свойство выполняется во время существующей рампы уровня тома, новый запрос на рампу должен начинаться с текущего уровня тома — уровня, достигаемого при поступлении нового запроса.

Требования

Версия

Windows 8

Заголовок

 Ksmedia.h

См. также

KSAUDIOENGINE_VOLUMELEVEL

KSNODEPROPERTY_AUDIO_CHANNEL

KSPROPERTY_AUDIOENGINE

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS