niSwitch Connect Channels

NI-SWITCH LabVIEW

niSwitch Connect Channels

Creates a path between channel 1 and channel 2. NI-SWITCH calculates and uses the shortest path between the two channels. Refer to Setting Source and Configuration Channels for information about channel usage types. Details

instrument handle identifies a particular NI-SWITCH session established with niSwitch Initialize With Topology, niSwitch Initialize With Options, or niSwitch Initialize.

channel 1 specifies one of the channel names of the desired path. Pass the other channel name as the channel 2. Refer to Devices for valid channel names for the switch module.

Examples of valid channel names:

ch0, com0, ab0, r1, c2, cjtemp

channel 2 specifies one of the channel names of the desired path. Pass the other channel name as the channel 1. Refer to Devices for valid channel names for the switch module.

Examples of valid channel names:

ch0, com0, ab0, r1, c2, cjtemp

error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurs before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

	status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.
	code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

instrument handle out identifies a particular NI-SWITCH session established with niSwitch Initialize With Topology, niSwitch Initialize With Options, or niSwitch Initialize and used for all subsequent NI-SWITCH calls.

error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

	status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
	code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

niSwitch Connect Channels Details

Note Paths are bidirectional. For example, if a path exists between channels CH1 and CH2, then the path also exists between channels CH2 and CH1.

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 niSwitch Connect Channels or niSwitch Set Path.
Is Configuration Channel	One of the channels is a configuration channel. Error elaboration contains information about which of the two channels is a configuration channel.
Attempt To Connect Sources	Both channels are connected to a source. Error elaboration contains information about the sources connected to channel 1 and 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 in use.

previous page start next page