User manual

2.3.53 AcqrsD1_forceTrig
Purpose
Forces a manual trigger. It should not be used for Averagers or Analyzers.
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
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. In multisegment mode, the current segment is acquired, the
acquisition is terminated and the data and timestamps of subsequent segments are invalid.
LabWindowsCVI/Visual C++ Representation
ViStatus status = AcqrsD1_forceTrig(ViSession instrumentID);
LabVIEW Representation
Acqiris Dx.lvlib: (or Aq Dx) Software Trigger.vi
Visual Basic Representation
ForceTrig (ByVal instrumentID As Long) As Long
Visual Basic .NET Representation
AcqrsD1_forceTrig (ByVal instrumentID As Int32) As Int32
MATLAB MEX Representation
See AcqrsD1_forceTrigEx
Programmer’s Reference Manual Page 104 of 210