查找现有的集合点或创建新的集合点并返回引用句柄。

可使用返回的引用句柄调用其他集合点VI。


icon

输入/输出

  • cstr.png 名称（未命名） —

    名称是正在查寻或需要创建的集合点的名称。

    默认为空字符串，用于创建未命名的集合点。LabVIEW不会自动释放已命名的集合点。
    注： 对任意已命名集合点，仅当第一个创建该集合点的顶层VI运行时，该集合点存在。例如，假设Subtask.vi是Application.vi的子VI，Application.vi停止执行时，可删除任何由Subtask.vi创建的已命名集合点。已命名的集合点可用于任何VI（包括不在Application.vi层次结构内的VI），但当Application.vi停止运行时，此类集合点也不复存在。
  • ci32.png 大小(2) —

    大小指定继续执行前需到达集合点的任务数量。

    默认值为2。如果一个命名的会合点已经存在，向 size 输入一个值并不会调整会合点的大小。通过调整集合点大小VI可改变已命名集合点的大小。

  • cbool.png 返回现有(F) —

    返回现有(F)指定是否需要已有集合点函数才能成功运行。

    默认值为FALSE，表示当集合点不存在时，必须创建集合点。如返回现有(F)的值为TRUE，指定名称的集合点不存在时，函数返回错误。

  • cerrcodeclst.png 错误输入（无错误） —

    错误输入表明该节点运行前发生的错误条件。该输入提供标准错误输入功能。

  • idlrn.png 集合点 —

    集合点表示对现有或新建集合点的引用。

  • ibool.png 新建 —

    新建VI创建新的集合点时值为TRUE。

  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

    • 如指定名称，VI首先搜索具有相同名称的集合点并返回其引用句柄。如不存在名称匹配的集合点且返回现有通知器为FALSE，则VI可创建新的集合点并返回其引用句柄。如VI已创建新的集合点，则新建为TRUE。

    注： 集合点无法用于LabVIEW应用程序实例之间的通信。在一个应用程序实例中创建的集合点引用，不能在另一个应用程序实例中使用。

    范例

    请参考LabVIEW附带的下列范例文件。

    • labview\examples\Synchronization\Rendezvous\Simple Rendezvous.vi