User manual

2.3.54 AcqrsD1_forceTrigEx
Purpose
Forces a manual trigger. It should not be used for Averagers or Analyzers.
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
forceTrigType ViInt32 = 0 Sends a software trigger to end the full acquisition
= 1 Sends a single software trigger and generates the
TrigOut hardware signal
modifier ViInt32 Currently not used
flags ViInt32 Currently not used
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
The function returns immediately after ordering the acquisition to stop. One must therefore wait until the
acquisition has terminated before reading the data, by checking the status with the
AcqrsD1_acqDone
function. If the external clock is enabled, and there is no clock signal applied to the device,
AcqrsD1_acqDone will never return done = VI_TRUE. Consider using a timeout and calling
AcqrsD1_stopAcquisition if it occurs.
For forceTrigType = 0, the 'trigOut' Control IO will NOT generate a trigger output. This mode is equivalent
to AcqrsD1_forceTrig. In multisegment mode, the current segment is acquired, the acquisition is
terminated and the data and timestamps of subsequent segments are invalid.
For forceTrigType = 1, 'trigOut' Control IO will generate a trigger output on each successful call. In
multisegment mode, the acquisition advances to the next segment and then waits again for a trigger. If no
valid triggers are provided to the device, the application must call AcqrsD1_forceTrigEx as many times as
there are segments. Every acquired segment will be valid. This mode is only supported for single (i.e. non-
AS bus-connected) digitizers (not Averagers or Analyzers).
Programmer’s Reference Manual Page 105 of 210