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

Интерфейс IKsJackDescription2 предоставляет сведения о разъемах или внутренних соединителях, которые обеспечивают физическое соединение между устройством на звуковом адаптере и внешним или внутренним устройством конечной точки (например, микрофоном или проигрывателем компакт-дисков).

Помимо получения сведений о разъеме, таких как тип подключения, IKsJackDescription в основном используется для сообщения о том, подключен ли разъем к устройству. Если в Windows 7 драйвер подключенного устройства поддерживает IKsJackDescription2, звуковой стек или приложение могут использовать этот интерфейс для получения дополнительных сведений о разъеме. Сюда входит возможность обнаружения разъема и динамическое изменение формата устройства.

Большинство драйверов аудиоадаптера Windows поддерживают модель драйвера Windows (WDM) и используют свойства потоковой передачи ядра (KS) для представления параметров описания оборудования в соединителях (называемых контактами KS). Интерфейс IKsJackDescription2 обеспечивает удобный доступ к свойству KSPROPERTY_JACK_DESCRIPTION2 соединителя к устройству конечной точки. Дополнительные сведения о свойствах KS и контактах KS см. в документации по Windows DDK.

Приложение получает ссылку на интерфейс IKsJackDescription2 части, вызывая метод IPart::Activate с параметром refiid , равным REFIIDIID_IKsJackDescription2. Вызов IPart::Activate завершается успешно, только если часть поддерживает интерфейс IKsJackDescription2 . Этот интерфейс поддерживает только объект part, представляющий соединитель мостового закрепления в объекте топологии устройства фильтра KS.

Пример кода см. в разделе IKsJackDescription.

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

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

Методы

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

IKsJackDescription2::GetJackCount Метод GetJackCount получает количество разъемов на соединителе, необходимых для подключения к устройству конечной точки.
IKsJackDescription2::GetJackDescription2 Метод GetJackDescription2 получает описание указанного аудиоразъема.

Требования

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

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

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

DeviceTopology API

IPart::Activate