IviSwtch_ConfigureScanTrigger

CVI/LabWindows IVI Class Driver

IviSwtch_ConfigureScanTrigger

IviSwtchScanner Capability Group

C Function Prototype

ViStatus IviSwtch_ConfigureScanTrigger (ViSession vi, ViReal64 scanDelay, ViInt32 triggerInput, ViInt32 scanAdvancedOutput);

Purpose

This function configures the scan triggers for the scan list you establish with the IviSwtch_ConfigureScanList function.

If the switch module is currently scanning through the scan list, this function returns the IVISWTCH_ERROR_SCAN_IN_PROGRESS error without configuring the scan trigger.

Parameters

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.
scanDelay ViReal64 Pass the minimum length of time you want the instrument to wait from the time the instrument creates a path until it asserts a trigger on the Scan Advanced output line. Express this value in seconds. The driver uses this value to set the IVISWTCH_ATTR_SCAN_DELAY attribute.
triggerInput ViInt32 Pass the trigger source you want the instrument to use for scanning. The driver uses this value to set the IVISWTCH_ATTR_TRIGGER_INPUT attribute.

The switch module waits for the trigger you specify when it encounters a semicolon in the scan list. When the trigger occurs, the switch module advances to the next entry in the scan list.

Defined Values
scanAdvanced
Output
ViInt32 Pass the output on which you want the instrument to assert the scan advanced signal. The driver uses this value to set the IVISWTCH_ATTR_SCAN_ADVANCED_OUTPUT attribute.

After the instrument processes each entry in the scan list, it waits the length of time you specify in the scanDelay parameter and then asserts a trigger on the line you specify with this parameter.

Defined Values

Return Values