KsStudio - 固定和节点

本主题介绍如何使用 KSStudio 实用工具显示引脚工厂和引脚实例化。

引脚工厂

音频筛选器的引脚工厂描述了筛选器可以实例化的所有引脚。 通常,KS 筛选器托管一个或多个引脚工厂。 有关详细信息,请参阅 Pin 工厂

在 KSStudio 实用工具 的对象拓扑视图中 ,引脚工厂位于筛选器上,以便从左到右绘制数据流。 下面显示了各种引脚类型及其表示形式。

通信Flow和数据流

Diagram showing KsStudio Pin Factories .

固定实例化

可通过多种方式在 KSStudio 中实例化引脚。

  • 手动实例化。 如果要控制引脚的格式,此方法非常有用。 右键单击固定工厂,然后从弹出菜单中选择实例化。 这会生成 KSPIN_CONNECT 参数对话框。

此对话框根据 KSPIN_CONNECT 用于实例化引脚的) 显示适当的结构 (。 显示的结构是对筛选器数据范围交集处理程序的调用的结果。 可以通过双击它们来更改结构和子结构的成员。 可以通过从中选择固定实例来填充 PinToHandle 成员。对话框底部的 ConnectTo 树。 确认对话后,KSPIN_CONNECT结构将作为参数传递给 KsCreatePin。

  • 自动实例化。 此方法用于将引脚连接在一起。 它比手动实例化要容易得多,但不允许控制引脚格式。 相反,它依赖于引脚本身的格式解脱机制。 只需将引脚工厂拖到固定实例或其他引脚上。 对于终结点的不同组合,协商机制不同:

    • 将通信源引脚工厂 A 拖到通信接收器引脚实例 B 上。格式协商在这里是微不足道的,因为已设置实例化引脚 (B) 的格式。 引脚工厂 (A) 只需实例化引脚 (B) 的句柄作为 PinConnectTo 参数进行实例化,并将实例化引脚的格式 (B) 作为数据格式。 将 Pin 实例拖到 Pin 工厂是此方法的一个小变体,可实现相同的结果。

    • 将通信源引脚工厂 A 拖到通信接收器引脚工厂 B 上。此处的格式协商是使用 DataRange 交集机械通道完成的。 源引脚工厂的 DataRange (A) 提交到接收器引脚工厂的 DataRange 交集处理程序, (B) 。 如果此调用成功,则用此格式实例化 Pin 工厂 B。 然后,固定工厂 A 以相同的格式实例化,现在固定实例的句柄 (B) 作为 PinHandleTo 成员。 将通信接收器引脚工厂拖到通信源引脚上是此方法的细微变化,可实现相同的结果。

对于使用上述方法实例化的每个引脚,将固定实例的表示形式添加到 “对象拓扑视图 ”和 “对象详细信息”视图中

Nodes

节点用于描述通过筛选器的数据流路径。 它们还用于声明属性调用产生的效果范围,如“节点上的属性和事件”中所述。

若要在图形视图中查看筛选器的节点,请右键单击筛选器并选择“视图节点”。

单击图形视图中的某个节点时,将调用以下 UI 操作:

  • 筛选中突出显示通过所选节点的每个路径

  • 选中树视图中节点的相应表示形式

请注意, (节点 (没有连接) 的孤立节点在筛选器图形域的左上角绘制。

节点上的属性和事件

通过通信目标 (筛选器和固定) 进行属性和事件调用。 作为这些属性和事件调用的参数,可以指定节点序号。 从这个意义上说,属性调用是通过固定或筛选器节点上的。

KSStudio 直观地表示 对象拓扑视图对象详细信息视图中的这些关系。

实例化引脚时,节点将作为图钉实例的子项添加到 “对象详细信息”视图中。 通过引脚在节点上查询这些节点上的属性。 请注意,节点上的大多数属性仅通过引脚或筛选器有意义,但不能通过两者。

另请参阅

KSStudio 实用工具

KSStudio - 筛选器和筛选器工厂

KSStudio - KSProperties 和事件

KSStudio - KS Monitor

KSStudio - 用法示例