IviScope_ConfigureTrigger
IviScopeBase Capability Group
C Function Prototype
ViStatus IviScope_ConfigureTrigger (ViSession vi, ViInt32 triggerType, ViReal64 holdoff);
Purpose
This function configures the common attributes of the trigger subsystem. These attributes are the trigger type, and trigger holdoff.
When you call IviScope_ReadWaveform, IviScope_ReadWaveformMeasurement, IviScope_ReadMinMaxWaveform, or IviScope_InitiateAcquisition, the oscilloscope waits for a trigger. You specify the type of trigger the oscilloscope waits for with the triggerType parameter.
If the oscilloscope requires multiple waveform acquisitions to build a complete waveform, it waits for the length of time you specify with the holdoff parameter to elapse since the previous trigger before rearming the trigger. After the oscilloscope acquires a complete waveform, it returns to the Idle state.
If the trigger source is one of the analog input channels, the vertical range, vertical offset, vertical coupling, probe attenuation, and maximum input frequency must be configured before calling this function.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The instrument handle that you obtain from the IviScope_init or IviScope_InitWithOptions functions. The handle identifies a particular IVI session. |
| triggerType | ViInt32 | Specifies the trigger type. The driver uses this value to set the IVISCOPE_ATTR_TRIGGER_TYPE attribute. |
| holdoff | ViReal64 | Specifies the trigger holdoff. The driver uses this value to set the IVISCOPE_ATTR_TRIGGER_HOLDOFF attribute. |