Свойство категории закрепления

Звуковые драйверы модели Microsoft Windows Driver Model (WDM) для USB-аудио устройств, аудиоустройств IEEE 1394 и аудиоустройств на внутренних шинах представляют свои устройства как фильтры KS с выводами. Звуковой драйвер WDM поддерживает одну KSPIN_DESCRIPTOR структуру для каждого типа пин-кода, который он поддерживает. В этой структуре драйвер сохраняет свойства KSPROPSETID_Pin типа пина. Среди этих свойств является свойство KSPROPERTY_PIN_CATEGORY . Запрос на это свойство извлекает GUID категории пин-кода KS из элемента категорииKSPIN_DESCRIPTOR структуры. Этот GUID указывает общую категорию функциональных возможностей, которые предоставляет пин-код. Например, идентификатор GUID определенной категории контактов, KSNODETYPE_HEADPHONES, обозначает контакт как выходной разъем для наушников.

В случае звукового устройства с поддержкой формата WAV на внутренней шине (например, PCI), драйвер минипорта PortCls содержит массив дескрипторов штырей, каждый из которых описывает тип штыря в фильтре, представляющем устройство. Каждый дескриптор контакта — это структура PCPIN_DESCRIPTOR, содержащая внедренную структуру KSPIN_DESCRIPTOR с GUID категории контакта. При получении клиентского запроса свойства KSPROPERTY_PIN_CATEGORY драйвер порта извлекает GUID категории контакта из дескриптора пина драйвера минипорта для указанного типа контакта. Дополнительные сведения о дескрипторах пин-кода см. в разделе "Фабрики пин-кода".

USB-звуковое устройство имеет некоторое количество терминалов, через которые цифровые потоки и аналоговые сигналы могут входить и выйти из устройства. При создании фильтра KS для представления USB-звукового устройства системный драйвер класса USBAudio преобразует терминалы устройства в контакты фильтра. Файл заголовка Ksmedia.h определяет сопоставление для каждого идентификатора типа терминала USB с GUID категории пин-кода KS. В следующих шести таблицах показаны идентификаторы типов терминала и соответствующие идентификаторы guid категории пин-кода.

Типы входных терминалов

Типы выходного терминала

Двунаправленные типы терминалов

Типы терминалов телефонии

Типы внешних терминалов

Типы встроенных терминалов функций

Дополнительные сведения об идентификаторах типа терминала USB см. в определении класса устройства универсальной шины для типов терминалов (выпуск 1.0), который доступен на веб-сайте форума разработчиков USB .

Все GUID категории контактов в предыдущих таблицах имеют имена параметров вида KSNODETYPE_XXX. Обратите внимание, что идентификаторы GUID типа KS узлов также имеют имена параметров KSNODETYPE_XXX. Это соглашение об именовании создает потенциальную возможность путаницы между GUID'ами категорий выводов и GUID'ами типов узлов. К счастью, почти каждый параметр KSNODETYPE_XXX определяет либо категорию контакта, либо тип узла, но не оба. Одним из исключений правила является KSNODETYPE_SYNTHESIZER, которое может определять или категорию вывода, или тип узла в зависимости от контекста. Список идентификаторов GUID типа узла смотрите в разделе «Узлы аудио топологии».

При создании экземпляра USB-звукового устройства системный драйвер класса USBAudio запрашивает у устройства его внутреннюю топологию, включая терминалы. С помощью этой информации драйвер USBAudio строит фильтр для представления устройства и преобразует каждый терминал в соответствующий контакт фильтра. В ходе этого процесса драйвер преобразует каждый идентификатор типа терминала USB в соответствующий GUID категории подключения KS, который является одним из GUID в предыдущих таблицах. Драйвер создает структуру KSPIN_DESCRIPTOR для описания пин-кода и записывает GUID категории пин-кода в структуру.

Минипорт-драйвер PortCls не обязательно использует только GUID категорий, указанные в предыдущих шести таблицах. Например, драйвер может определить и использовать идентификатор GUID пользовательской категории пин-кода для описания типа пин-кода, функциональная категория которого выходит за рамки категорий в таблицах. Естественно, настраиваемый GUID категории пин-кода полезен только для клиентов, которые распознают GUID.

Звуковая подсистема поддерживает список GUID идентификаторов категорий контактов и связанных с ними удобочитаемых имен в системном реестре. Установщик класса мультимедиа копирует пары GUID-name в реестр из файла Ks.inf, расположенного в подпапке Inf основной папки Windows (например, C:\Windows\Inf\Ks.inf).

Операционная система использует категории контактов для связывания понятных имен с устройствами конечной точки аудио. Дополнительные сведения о связывании понятных имен с устройствами конечной точки аудио см. в разделе "Понятные имена" для устройств конечной точки аудио.