DAQmxSwitchFindPath

NI-DAQmx C Functions

previous page next page

DAQmxSwitchFindPath

int32 DAQmxSwitchFindPath (const char switchChannel1[], const char switchChannel2[], char path[], uInt32 pathBufferSize, int32 *pathStatus);

Purpose

Returns information about the path between switchChannel1 and switchChannel2. If the channels are connected, this function returns the path by which they are connected. If the channels are not connected, the function returns a path by which they could be connected, if one is available.

Parameters

Input

Name

Type

Description

switchChannel1

const char []

The first channel to connect.

switchChannel2

const char []

The second channel to connect.

pathBufferSize

uInt32

The size of path. If you pass 0, this function returns the size of the buffer needed to allocate.

Output

Name

Type

Description

path

char []

The existing path or an available path between switchChannel1 and switchChannel2. This path uses the same syntax as a connection or disconnection list. If you pass NULL, this function returns the size of the buffer needed to allocate.

pathStatus

int32 *

The status of the requested path. The following values can be returned:

Value		Description
DAQmx_Val_PathStatus_Available		path returns the available path between the channels.
DAQmx_Val_PathStatus_AlreadyExists		The channels are already connected by path.
DAQmx_Val_PathStatus_Unsupported		No path is available between the channels. You might need to reserve more channels for routing to create an available path.
DAQmx_Val_PathStatus_ChannelInUse		Path between the two endpoints is not available because another connection is already using a channel needed for routing.
DAQmx_Val_PathStatus_SourceChannelConflict		No path is available between the two channels because connecting the channels would directly or indirectly connect two source channels.
DAQmx_Val_PathStatus_ChannelReservedForRouting		One of the endpoint channels is reserved for routing.

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A negative value indicates an error. For this function, if you pass NULL for the buffer or 0 for the buffer size, this function returns the number of bytes needed to allocate.

previous page start next page