KsStudio — фильтры и фабрики
В этом разделе описывается, как можно отобразить фильтры и фабрики фильтров с помощью служебной программы KSStudio.
Аудиодрайверы модели драйвера Microsoft Windows (WDM) представляют звуковое устройство в виде фильтра KS, а также аппаратный буфер на устройстве в виде закрепления на фильтре. Дополнительные сведения см. в разделе Свойства фильтра, закрепления и узла.
Параметры перечисления фабрики фильтров KS
Сеанс в KSStudio обычно начинается с перечисления фабрик фильтров KS, установленных в системе. По умолчанию при запуске пользователю предоставляется диалоговое окно параметров перечисления. Это диалоговое окно можно вызвать в любое время после запуска с помощью панели меню (Вид.Параметры...).
Существует два способа перечисления фильтров KSStudio.
API установки. Это, безусловно, наиболее распространенное и полезное средство перечисления фабрики фильтров. Если фабрика фильтров правильно установлена в системе, она будет перечисляться через одну или несколько категорий фильтров (например, KSCATEGORY_AUDIO, KSCATEGORY_RENDER и т. д. ). Вы можете выбрать категории для перечисления, нажав кнопку "Классы..." Кнопку. При этом вызывается диалоговое окно, в которое представлены все категории, объявленные в настоящее время в KSMedia.h.
Явно по имени устройства. Если API установки не перечисляет фабрику фильтров, но драйвер установлен (т. е. он отображается без ошибок в диспетчер устройств), вы можете явно создать экземпляр устройства по имени. Для этого введите имя устройства в элементе управления "Дополнительные фильтры". Это может быть полезно при устранении проблем с перечислением (например, ошибок INF).
KSStudio также предоставляет несколько "тестовых фильтров", которые существуют только в программе KSStudio. Эти тестовые фильтры можно использовать для потоковой передачи данных непосредственно в фильтры KS, что может быть полезно для устранения неполадок.
Установленные фабрики фильтров, перечисляемые KSStudio, отображаются в представлении фабрики фильтров , описанном в служебной программе KSStudio.
Фабрики фильтров
Перечисленные фабрики фильтров отображаются в представлении фабрики фильтров. Фабрика фильтров — это аспект драйвера WDM, предоставляющий имя устройства, которое может быть передано CreateFile
для создания экземпляра фильтра (который является объектом ядра). Для каждой фабрики фильтров KSStudio отображает сокращенный список атрибутов, полученных с помощью API-интерфейсов установки Windows, без фактического создания экземпляра фильтра.
Атрибут Имя устройства — это строка, передаваемая CreateFile
KSStudio, когда пользователь решает создать экземпляр фильтра.
Создание экземпляра фильтра
Чтобы создать экземпляр фильтра, дважды щелкните фабрику фильтров в представлении "Фабрика фильтров " (или щелкните правой кнопкой мыши фабрику и выберите создать экземпляр). В случае успешного создания экземпляра KSStudio опрашивает фильтр (с помощью шквал вызовов свойств) и создает профиль, используя полученные значения. Этот профиль используется для создания графического представления экземпляра фильтра в представлении топологии объектов, которое выводится из значений свойств, и текстового представления в представлении сведений об объекте , в котором показаны фактические полученные значения свойств.
Чтобы закрыть фильтр, щелкните его правой кнопкой мыши и выберите пункт Закрыть во всплывающем меню.
Тестовые фильтры
KSStudio поставляется с несколькими встроенными фильтрами тестирования или потоками данных, которые называются так, поскольку они отправляют буферы данных, которые либо заполняются, либо потребляются графом фильтров KS.
Волновой файловый насос. Этот фильтр считывает WAV-файлы и отправляет данные в контакты, способные использовать KSDATAFORMAT_TYPE_AUDIO данные.
Файловый насос MIDI. Этот фильтр считывает файлы MID или RMI и отправляет данные в контакты, способные использовать KSDATAFORMAT_TYPE_MUSIC данные.
Насос захвата волн. Этот фильтр отправляет пустые буферы в контакты, которые могут предоставлять KSDATAFORMAT_AUDIO данные. Данные отображаются с помощью единицы измерения VU.
Насос захвата MIDI. Этот фильтр отправляет пустые буферы в контакты, которые могут предоставлять KSDATAFORMAT_MUSIC данные. Данные отображаются в окне ведения журнала в виде необработанных и переведенных сообщений MIDI.
Полнодуплексный потоковый насос. Этот фильтр отправляет пустые буферы в контакт KSDATAFLOW_IN, а затем повторно отправляет данные, полученные в KSDATAFLOW_OUT контакт. Например, этот насос можно использовать для записи данных PCM из контакта микрофона и повторной отправки их в контакт отрисовки.