DAQmxConnectTerms

NI-DAQmx C Functions

DAQmxConnectTerms

int32 DAQmxConnectTerms (const char sourceTerminal[], const char destinationTerminal[], int32 signalModifiers);

Purpose

Creates a route between a source and destination terminal. The route can carry a variety of digital signals, such as triggers, clocks, and hardware events.

These source and destination terminals can be on different devices as long as a connecting public bus, such as RTSI or the PXI backplane, is available. DAQmxConnectTerms does not modify a task. When DAQmxConnectTerms runs, the route is immediately reserved and committed to hardware. This type of routing is called immediate routing.

Parameters

Input
Name Type Description
sourceTerminal const char [] The originating terminal of the route. You can specify a terminal name.
destinationTerminal const char [] The receiving terminal of the route. You can specify a terminal name.
signalModifiers int32 Specifies whether or not to invert the signal routed from the sourceTerminal to the destinationTerminal. If the device is not capable of signal inversion or if a previous route reserved the inversion circuitry in an incompatible configuration, attempting to invert the signal causes an error.
Value Description
DAQmx_Val_DoNotInvertPolarity Do not invert the signal.
DAQmx_Val_InvertPolarity Invert the signal.

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 positive value indicates a warning. A negative value indicates an error.