Admin Production ni-theme
Current Publication

Can Connect Channels

IVI Compliance Package

IviSwtch Can Connect Channels

IviSwtch Base Capability Group

This VI verifies that the switch module is capable of creating a path between the two channels you specify with the channel 1 and channel 2 parameters. If the switch module is capable of creating a path, this VI indicates whether the path is currently available given the existing connections.

If the path is not available due to currently existing connections, but the implicit connection between the two channels already exists, the VI returns the warning IVISWTCH_WARN_IMPLICIT_CONNECTION_EXISTS (0x3FFA2002).

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 verify 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 through 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 verify 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 through 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.

path capabilityIndicates whether a path is valid. Possible values include:

IVISWTCH_VAL_PATH_AVAILABLE—1

IVISWTCH_VAL_PATH_EXISTS—2

IVISWTCH_VAL_PATH_UNSUPPORTED—3

IVISWTCH_VAL_RSRC_IN_USE—4

IVISWTCH_VAL_SOURCE_CONFLICT—5

IVISWTCH_VAL_CHANNEL_NOT_AVAILABLE—6

Note  
  1. IVISWTCH_VAL_PATH_AVAILABLE indicates that the driver can create the path at this time.
  2. IVISWTCH_VAL_PATH_EXISTS indicates that the explicit path between the channels already exists.
  3. IVISWTCH_VAL_PATH_UNSUPPORTED indicates that the instrument is not capable of creating a path between the two channels.
  4. IVISWTCH_VAL_RSRC_IN_USE indicates that although the path is valid, the driver cannot create the path at this moment because the switch module is currently using one or more of the required channels to create another path. You must destroy the other path before creating this one.
  5. IVISWTCH_VAL_SOURCE_CONFLICT indicates that the instrument cannot create a path because both channels are connected to a different source channel.
  6. IVISWTCH_VAL_CHANNEL_NOT_AVAILABLE indicates that the driver cannot create a path between the two channels because one of the channels is a configuration channel and thus unavailable for external connections.