KsStudio — закрепление и узлы
В этом разделе описывается, как можно отобразить экземпляры закреплений и закреплений с помощью программы KSStudio.
Закрепление фабрик
Фабрики закреплений аудиофильтра описывают все пин-коды, которые может создать фильтр. Как правило, фильтры KS размещают один или несколько заводов закреплений. Дополнительные сведения см. в разделе "Закрепление фабрик".
В представлении топологии объектов служебной программы KSStudio закрепление фабрик находится в фильтре таким образом, что поток данных рисуется слева направо. Ниже показаны различные типы закреплений и их представления.
Поток коммуникации и Поток данных
Создание экземпляра пин-кода
Существует несколько способов создания экземпляра пин-кода в KSStudio.
- Создание экземпляра вручную. Этот метод полезен, если вы хотите управлять форматом пин-кода. Щелкните правой кнопкой мыши фабрику закреплений и выберите "Создать экземпляр" в всплывающем меню. При этом создается диалоговое
KSPIN_CONNECTокно параметров.
В этом диалоговом окне показана соответствующая структура (на основе KSPIN_CONNECT), используемая для создания экземпляра пин-кода. Показанная структура является результатом вызова обработчика пересечения диапазона данных фильтров. Элементы структуры и подструктур можно изменить, дважды щелкнув их. Элемент PinToHandle можно заполнить, выбрав экземпляр пин-кода из элемента . дерево Подключение To в нижней части диалогового окна. При подтверждении диалогового окна структура KSPIN_CONNECT передается в KsCreatePin в качестве параметра.
Автоматическое создание экземпляров. Этот метод используется для соединения контактов. Это гораздо проще, чем создание экземпляров вручную, но не позволяет контролировать формат закреплений. Вместо этого он полагается на механизмы согласования формата самих закреплений. Просто перетащите фабрику контактов на экземпляр пин-кода или другой пин-код. Механизм согласования отличается для различных сочетаний конечных точек:
Перетащите фабрику контактов источника связи A в экземпляр пин-кода приемника коммуникации B. Согласование формата является тривиальным, так как формат экземпляра пин-кода (B) уже задан. Фабрика контактов (A) просто создает экземпляр, указывающий дескриптор экземплярированного пин-кода (B) в качестве параметра Pin Подключение To и формат экземплярного пин-кода (B) в качестве формата данных. Перетаскивание экземпляра пин-кода в фабрику пин-кода является незначительным вариантом этого метода, который достигает того же результата.
Перетащите фабрику контактов источника связи A в фабрику контактов приемника коммуникации B. Здесь выполняется согласование формата с помощью механизма пересечения DataRange. DataRange исходной фабрики закреплений (A) передается обработчику пересечения DataRange фабрики закреплений приемника (B). Если этот вызов выполнен успешно, то экземпляр фабрики пин-кода B создается с помощью этого формата. Затем фабрика пин-кода A создается с таким же форматом и с дескриптором экземпляра пин-кода (B) с элементом
PinHandleTo. Перетаскивание фабрики контактов приемника связи на пин-код источника связи является незначительным вариантом этого метода, который достигает того же результата.
Для каждого экземпляра пин-кода, созданного с помощью приведенных выше методов, в представление "Топология объектов" и "Сведения о объекте" добавляются представления пин-кода.
Узлы
Узлы используются для описания пути потока данных через фильтр. Они также используются для объявления область эффекта, которое приводит к вызову свойства, как описано ниже в разделе "Свойства и события на узлах".
Чтобы просмотреть узлы фильтра в представлении графа, щелкните правой кнопкой мыши фильтр и выберите пункт "Просмотр узлов".
При щелчке узла в представлении графа вызываются следующие действия пользовательского интерфейса:
Каждый путь через выбранный узел выделен в фильтре
Выбрано соответствующее представление узла в представлении дерева
Обратите внимание, что потерянные узлы (узлы без подключений) рисуются в левом верхнем углу графического домена фильтров.
Свойства и события на узлах
Вызовы свойств и событий выполняются с помощью целевых объектов связи (фильтров и закреплений). В качестве параметра для этих вызовов свойств и событий можно указать порядковый номер узла. В этом смысле вызов свойства, как говорят, находится на узле через закрепление или фильтр.
KSStudio визуально представляет эти связи как в представлении топологии объектов, так и в представлении сведений об объекте.
При создании экземпляра пин-кода узлы добавляются в качестве дочерних элементов экземпляра пин-кода в представлении сведений об объекте. Свойства на этих узлах запрашиваются на узлах через закрепление. Обратите внимание, что большинство свойств на узлах имеет смысл только через закрепление или через фильтр, но не через оба.
См. также
KSStudio — фильтры и фабрики фильтров