|NI TestStand 2014 Help|
|NI TestStand 2014 SP1 Help|
|TestStand 2016 Help|
|TestStand 2016 SP1 Help|
|TestStand 2017 Help|
This example demonstrates how to pass a TestStand container as a LabVIEW cluster to a LabVIEW VI. The container consists of several different data types. The VIs are compiled into a DLL and called as functions.
<TestStand Public>\Examples\Fundamentals\Passing Clusters to Code Modules\Passing Clusters to Code Modules.seq
You do not need to have the LabVIEW development system installed to use this example, but you must have the LabVIEW development system installed if you want to review the source VIs.
The sequence specifies ContainerOut and ContainerIn container local variables, which you can review on the Variables pane. When the sequence runs, TestStand copies the values in the ContainerOut container to the individual local variables, and then copies the values again to the ContainerIn container. A VI handles both operations. Before you run the sequence, the ContainerOut container contains values, the ContainerIn container contains default values, and the individual local variables contain default values.
Complete the following steps to use this example.
You can review the two Message Popup steps in the sequence to verify that the appropriate sources are providing values. You can open VI1.vi and VI2.vi, located in the <TestStand Public>\Examples\Fundamentals\Passing Clusters to Code Modules directory, to see how the data is being copied. The VI1.vi uses an unbundle function to separate the values from the cluster, and the VI2.vi uses a bundle function to combine individual values into a single cluster.
To pass a TestStand container as a cluster to a VI, you must complete the following tasks:
Complete the following steps to use the Types window to review the data type definition for a container.