IviSwtch Get Path
IviSwtch Base Capability Group
In some cases there is more than one possible path between two channels. The driver or the instrument selects the path when you connect two channels with the IviSwtch Connect Channels VI. Thus, you cannot guarantee that every call to the IviSwtch Connect Channels VI establishes exactly the same path when you pass the same channels. This VI returns a string that uniquely identifies the path you create with the IviSwtch Connect Channels VI. You can pass this string to the IviSwtch Set Path VI to establish the exact same path in the future.
If no explicit path exists between the two specified channels, this VI returns the IVISWTCH_ERROR_NO_SUCH_PATH (0xBFFA2008) error.
 |
Note This VI returns only those paths that you explicitly create by calling IviSwtch Connect Channels and IviSwtch Set Path VIs. For example, if you connect channels CH1 and CH3, and then channels CH2 and CH3, the explicit path between channels CH1 and Ch2 does not exist and this VI returns the IVISWTCH_ERROR_NO_SUCH_PATH (0xBFFA2008) error. |
 |
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 get 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 get 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. |
 |
path The comma-separated path between channels you specify in the Channel 1 and Channel 2 parameters. |
 |
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. |