IviSwtch_SendSoftwareTrigger
IviSwtchSoftwareTrigger Capability Group
C Function Prototype
ViStatus IviSwtch_SendSoftwareTrigger (ViSession vi);
Purpose
This function sends a command to trigger the instrument.
You must set the IVISWTCH_ATTR_TRIGGER_INPUT attribute to IVISWTCH_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 IVISWTCH_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 IviSwtch_error_query function at the conclusion of the sequence.
Parameter
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The instrument handle that you obtain from the IviSwtch_init or IviSwtch_InitWithOptions functions. The handle identifies a particular IVI session. |