IviDmm_SendSoftwareTrigger

CVI/LabWindows IVI Class Driver

IviDmm_SendSoftwareTrigger

IviDmmSoftwareTrigger Capability Group

C Function Prototype

ViStatus IviDmm_SendSoftwareTrigger (ViSession vi);

Purpose

This function sends a command to trigger the instrument.

You must set the IVIDMM_ATTR_TRIGGER_SOURCE or the IVIDMM_ATTR_SAMPLE_TRIGGER attribute to IVIDMM_VAL_SOFTWARE_TRIG before you can successfully call this function.

If the above condition is not true, this function does not send the software trigger and returns the error IVIDMM_ERROR_TRIGGER_NOT_SOFTWARE.

This function does not normally check the instrument status. Typically, you call this function only in a sequence of calls to other low-level driver functions. The sequence performs one operation. You use the low-level functions to optimize one or more aspects of interaction with the instrument. If you want to check the instrument status, call the IviDmm_error_query function at the conclusion of the sequence.

Parameter

Name Type Description
vi ViSession The instrument handle that you obtain from the IviDmm_init or IviDmm_InitWithOptions functions. The handle identifies a particular IVI session.

Return Values