KsStudio — пины и узлы

В этом разделе описывается, как можно отобразить фабрики закреплений и экземпляры закреплений с помощью утилиты KSStudio.

Фабрики шпилек

Фабрики разъемов аудиофильтра описывают все разъемы, которые может создать фильтр. Как правило, фильтры KS содержат одну или несколько пин-фабрик. Для получения дополнительной информации см. "Фабрики Pin".

В представлении топологии объектов служебной программы KSStudio штифтовые фабрики располагаются на фильтре таким образом, что поток данных отображается слева направо. Ниже показаны различные типы закреплений и их представления.

Поток коммуникации и поток данных

Создание экземпляра пин-кода

Существует несколько способов создания экземпляра пин-кода в KSStudio.

• Создание экземпляра вручную. Этот метод полезен, если вы хотите управлять форматом пин-кода. Щелкните правой кнопкой мыши фабрику закреплений и выберите "Создать экземпляр" в всплывающем меню. При этом создается диалоговое KSPIN_CONNECT окно параметров.

В этом диалоговом окне показана соответствующая структура (на основе KSPIN_CONNECT), используемая для создания экземпляра пин-кода. Показанная структура является результатом вызова обработчика пересечения диапазона данных фильтров. Элементы структуры и подструктур можно изменить, дважды щелкнув их. Элемент PinToHandle можно заполнить, выбрав экземпляр пина из дерева .ConnectTo в нижней части диалогового окна. При подтверждении диалогового окна структура KSPIN_CONNECT передается в KsCreatePin в качестве параметра.

• Автоматическое инстанцирование. Этот метод используется для соединения штырей. Это гораздо проще, чем создание экземпляров вручную, но не позволяет контролировать формат выводов. Вместо этого он полагается на механизмы согласования формата самих закреплений. Просто перетащите фабрику штифтов на экземпляр штифта или другой штифт. Механизм согласования отличается для различных сочетаний конечных точек:

  • Перетащите фабрику контактов источника связи A в экземпляр пин-кода приемника коммуникации B. Согласование формата является тривиальным, так как формат экземпляра пин-кода (B) уже задан. Фабрика выводов (A) просто создается, указывая дескриптор инстанцированного вывода (B) в качестве параметра PinConnectTo, а формат инстанцированного вывода (B) в качестве формата данных. Перетаскивание Pin Instance на Pin Factory является незначительным вариантом этого метода, который достигает того же результата.

  • Перетащите фабрику пинов источника связи A в фабрику пинов приемника связи B. Здесь согласование формата выполняется с помощью механизма пересечения DataRange. Диапазон данных (DataRange) исходного контакта (A) передается обработчику пересечения диапазона данных фабрики приема контактов (B). Если вызов выполнен успешно, Фабрика pin-кодов B инициализируется в этом формате. Затем Фабрика пинов A создается с таким же форматом, и с дескриптором экземпляра Пина (B) как элемент PinHandleTo. Перетаскивание фабрики приемных контактов на контактный вывод источника связи является незначительной вариацией этого метода, которая достигает того же результата.

Для каждого экземпляра пина, созданного с помощью приведенных выше методов, представления экземпляра пина добавляются как в представление "Топология объектов", так и в "Сведения об объекте".

Узлы

Узлы используются для описания пути потока данных через фильтр. Они также используются для объявления области действия, которая является результатом вызова свойства, как описано ниже в разделе "Свойства и события узлов".

Чтобы просмотреть узлы фильтра в представлении графа, щелкните правой кнопкой мыши фильтр и выберите пункт "Просмотр узлов".

При щелчке узла в представлении графа вызываются следующие действия пользовательского интерфейса:

• Каждый путь через выбранный узел выделен в фильтре

• Выбрано соответствующее представление узла в представлении дерева

Обратите внимание, что потерянные узлы (узлы без подключений) рисуются в левом верхнем углу графического домена фильтров.

Свойства и события на узлах

Вызовы свойств и событий выполняются через целевые коммуникационные элементы (фильтры и пины). В качестве параметра для этих вызовов свойств и событий можно указать порядковый номер узла. В этом смысле вызов свойства предполагается на узле через контакт или фильтр.

KSStudio визуально представляет эти связи как в представлении топологии объектов , так и в представлении сведений об объекте.

При создании экземпляра пин-кода узлы добавляются в качестве дочерних элементов экземпляра пин-кода в представлении сведений об объекте. Свойства на этих узлах запрашиваются через контакты на узлах. Обратите внимание, что большинство свойств на узлах имеют смысл только через закрепление или через фильтр, но не через оба.

См. также

Утилита KSStudio

KSStudio — фильтры и фабрики фильтров

KSStudio — KSProperties и Events

KSStudio — монитор KS

KSStudio — примеры использования