Admin Production ni-theme
Current Publication

Connect Channels

IVI Compliance Package

IviSwtch Connect Channels

IviSwtch Base Capability Group

This VI creates a path between channel 1 and channel 2. The driver calculates the shortest path between the two channels. Details

This VI applies default values to properties that have not been set by you under the following conditions:

If you have not set the value of any property in the IviSwtchScanner extension, the following default values are used:

IviSwtch Scan List [SCN]—"" (Empty string)

IviSwtch Trigger Input [SCN]—IVISWTCH_VAL_EXTERNAL

IviSwtch Scan Advanced Output [SCN]—IVISWTCH_VAL_EXTERNAL

IviSwtch Scan Delay [SCN]—0

instrument handle The instrument handle that you obtain from the IviSwtch Initialize or IviSwtch Initialize With Options VI.
channel 1 ("") You identify a path with two channels. Pass one of the virtual channel names for which you want to create a path. Pass the other channel name as the channel 2 parameter.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel in MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Default Value: ""

channel 2 ("") You identify a path with two channels. Pass one of the virtual channel names for which you want to create a path. Pass the other channel name as the channel 1 parameter.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel in MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Default Value: ""

error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviSwtch Initialize or IviSwtch Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

If a path is not available, the VI returns one of the following errors:

IVISWTCH_ERROR_EXPLICIT_CONNECTION_EXISTS (0xBFFA200C)—if the two channels are already explicitly connected by calling either the IviSwtch Connect Channels or IviSwtch Set Path VI.

IVISWTCH_ERROR_IS_CONFIGURATION_CHANNEL (0xBFFA2009)—if a channel is a configuration channel. Call IviSwtch_GetError for information about which of the two channels is a configuration channel.

IVISWTCH_ERROR_ATTEMPT_TO_CONNECT_SOURCES (0xBFFA200B)—if both channels are connected to a different source. Call IviSwtch_GetError for sources to which channel 1 and 2 connect.

IVISWTCH_ERROR_CANNOT_CONNECT_TO_ITSELF (0xBFFA2015)—if channels 1 and 2 are one and the same channel.

IVISWTCH_ERROR_PATH_NOT_FOUND (0xBFFA2011)—if the driver cannot find a path between the two channels.

IviSwtch Connect Channels Details

Notes
  1. The paths are bidirectional. For example, if a path exists from channel CH1 to CH2, then a path from channel CH2 to CH1 also exists.
  2. This VI performs interchangeability checking when the IviSwtch Interchange Check property is set to TRUE. Use NI I/O Trace to view interchangeability warnings. Alternately, you may use the IviSwtch Get Next Interchange Warning VI to retrieve interchangeability warnings. For more information about interchangeability checking, refer to the help text for the IviSwtch Interchange Check property.