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


Интерфейс IAudioVolumeLevel (devicetopology.h)

Интерфейс IAudioVolumeLevel предоставляет доступ к аппаратному элементу управления громкостью. Клиент получает ссылку на интерфейс IAudioVolumeLevel подсоединения, вызывая метод IPart::Activate с параметром refiid , равным REFIID IID_IAudioVolumeLevel. Вызов IPart::Activate завершается успешно, только если подъединит поддерживает интерфейс IAudioVolumeLevel . Только объект subunit, представляющий аппаратный элемент управления уровня тома, будет поддерживать этот интерфейс.

Интерфейс IAudioVolumeLevel предоставляет элементы управления для каждого канала для настройки и получения уровней усиления или затухания в аудиопотоке. Если аппаратный элемент управления на уровне громкости может только затухать каналы в аудиопотоке, то максимальный уровень громкости для любого канала составляет 0 дБ. Если элемент управления уровня громкости может обеспечить увеличение (усиление), максимальный уровень громкости больше 0 дБ.

Большинство драйверов аудиоадаптера Windows поддерживают модель драйвера Windows (WDM) и используют свойства потоковой передачи ядра (KS) для представления параметров управления оборудованием в подсоединителях (называемых узлами KS). Интерфейс IAudioVolumeLevel предоставляет удобный доступ к свойству KSPROPERTY_AUDIO_VOLUMELEVEL подъединения со значением GUID подтипа KSNODETYPE_VOLUME. Чтобы получить GUID подтипа подсоединения, вызовите метод IPart::GetSubType . Дополнительные сведения о свойствах KS и типах узлов KS см. в документации по Windows DDK.

Наследование

Интерфейс IAudioVolumeLevel наследуется от интерфейса IPerChannelDbLevel.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

См. также раздел

Основные звуковые интерфейсы

DeviceTopology API

IPart::Activate

Интерфейс IPerChannelDbLevel