Creates a path between two channels. NI-SWITCH calculates and uses the shortest path between the two channels.
Control that identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology node, the niSwitch Initialize With Options node, or the niSwitch Initialize node.
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Default: No error
One of the channel names of the desired path. Pass the other channel name as channel 2.
Examples of valid channel names are ch0, com0, ab0, r1, c2, and cjtemp.
One of the channel names of the desired path. Pass the other channel name as channel 1.
Examples of valid channel names are ch0, com0, ab0, r1, c2, and cjtemp.
Indicator that identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology node, the niSwitch Initialize With Options node, or the niSwitch Initialize node and used for all subsequent NI-SWITCH calls.
Error information.
The node produces this output according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
If a path is unavailable between the two channels, NI-SWITCH returns the following errors:
Error | Description |
---|---|
Explicit Connection Exists | The channels have already been explicitly connected by calling either this node or the niSwitch Set Path node. |
Is Configuration Channel | One of the channels is a configuration channel. Error elaboration contains information about the sources connected to channel 1 and channel 2. |
Attempt to Connect Sources | Both channels are connected to a source. Error elaboration contains information about the sources connected to channel 1 and channel 2. |
Cannot Connect to Itself | Channel 1 and channel 2 are identical. |
Path Not Found | No paths between channel 1 and channel 2 are available. |
Resource In Use | Channel 1 and/or channel 2 is in use. This error often occurs when one of the channels is set as a configuration channel and is in use or if one of the channels is a common multiplexer channel is in use. |
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Not supported in VIs that run in a web application