niScope_ExportSignal
- Updated2023-02-21
- 2 minute(s) read
C Function Prototype
ViStatus niScope_ExportSignal (ViSession vi, ViInt32 signal, ViConstString signalIdentifier, ViConstString outputTerminal);
Purpose
 |
Note This function replaces niScope_ConfigureTriggerOutput. |
Configures the digitizer to generate a signal that other devices can detect when configured for digital triggering or sharing clocks. The signal parameter specifies what condition causes the digitizer to generate the signal. The outputTerminal parameter specifies where to send the signal on the hardware (such as a PFI connector or RTSI line).
In cases where multiple instances of a particular signal exist, use the signalIdentifier input to specify which instance to control. For normal signals, only one instance exists and you should leave this parameter set to the empty string. You can call this function multiple times and set each available line to a different signal.
To unprogram a specific line on device, call this function with the signal you no longer want to export and set outputTerminal to NISCOPE_VAL_NONE.
Related topics:
Parameters
| Input | |||||||||||||||||||||||||||||||||||
| Name | Type | Description | |||||||||||||||||||||||||||||||||
| vi | ViSession | The instrument handle you obtain from niScope_init that identifies a particular instrument session. | |||||||||||||||||||||||||||||||||
| signal | ViInt32 | Signal (clock, trigger, or event) to export.
Defined Values
|
|||||||||||||||||||||||||||||||||
| signalIdentifier | ViConstString | Describes the signal being exported. | |||||||||||||||||||||||||||||||||
| outputTerminal | ViConstString | Identifies the hardware signal line on which the digital pulse is
generated.
Defined Values
| |||||||||||||||||||||||||||||||||
Return Value
| Name | Type | Description | ||||||||
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code,
call
niScope_GetErrorMessage.
To obtain additional information concerning the error
condition, use niScope_GetError
and
niScope_ClearError.
The general meaning of the status code is as follows:
|