niSwitch_SetPath

NI-SWITCH Functions

niSwitch_SetPath

IviSwtchBase Capability Group

C Function Prototype

ViStatus niSwitch_SetPath (ViSession vi, ViConstString pathList);

Purpose

Connects two channels by specifying an explicit path in pathList. niSwitch_SetPath is particularly useful where path repeatability is important, such as in calibrated signal paths. If this is not necessary, use niSwitch_Connect.

Parameters

Name Type Description
vi ViSession A particular NI-SWITCH session established with niSwitch_InitWithTopology, niSwitch_InitWithOptions, or niSwitch_init and used for all subsequent NI-SWITCH calls.

pathList ViConstString A string composed of comma-separated paths between channel 1 and channel 2. The first and last names in the path are the endpoints of the path. Every other channel in the path are configuration channels.

Example of a valid path list string:

ch0->com0, com0->ab0.

In this example, com0 is a configuration channel.



Obtain the path list for a previously created path with niSwitch_GetPath.