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

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

Клиент интерфейса IAudioChannelConfig программировать элемент управления конфигурацией аппаратного канала, записывая маску конфигурации канала в элемент управления . Маска указывает назначение звуковых каналов динамикам. Дополнительные сведения о масках конфигурации каналов см. в разделе KSPROPERTY_AUDIO_CHANNEL_CONFIG.

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

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

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

Методы

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

 
IAudioChannelConfig::GetChannelConfig

Метод GetChannelConfig получает текущую маску конфигурации канала из элемента управления конфигурацией канала.
IAudioChannelConfig::SetChannelConfig

Метод SetChannelConfig задает маску конфигурации канала в элементе управления конфигурацией канала.

Требования

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

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

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

DeviceTopology API

IPart::Activate