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 |