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

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

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

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

Интерфейс IAudioAutoGainControl наследуется от интерфейса IUnknown . IAudioAutoGainControl также имеет следующие типы элементов:

Методы

Интерфейс IAudioAutoGainControl содержит следующие методы.

 
IAudioAutoGainControl::GetEnabled

Метод GetEnabled получает текущее состояние AGC (включено или отключено).
IAudioAutoGainControl::SetEnabled

Метод SetEnabled включает или отключает AGC.

Требования

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

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

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

DeviceTopology API

IPart::Activate