IviScope_ConfigureWidthTriggerSource

CVI/LabWindows IVI Class Driver

IviScope_ConfigureWidthTriggerSource

IviScopeWidthTrigger Capability Group

C Function Prototype

ViStatus IviScope_ConfigureWidthTriggerSource (ViSession vi, ViConstString source, ViReal64 level, ViReal64 widthLowThreshold, ViReal64 widthHighTreshold, ViInt32 widthPolarity, ViInt32 widthCondition);

Purpose

This function configures the oscilloscope for width triggering.

A width trigger occurs when the oscilloscope detects a positive or negative pulse with a width between, or optionally outside, the width thresholds. You specify the width thresholds with the widthLowThreshold and widthHighThreshold parameters. You specify whether the oscilloscope triggers on pulse widths that are within or outside the width thresholds with the widthCondition parameter. You specify the polarity of the pulse with the widthPolarity parameter. The trigger does not actually occur until the edge of a pulse that corresponds to the widthLowThreshold, widthHighThreshold, widthCondition, and widthPolarity crosses the threshold you specify with the level parameter.

This function affects instrument behavior only if the trigger type is IVISCOPE_VAL_WIDTH_TRIGGER. Call the IviScope_ConfigureTrigger function to set the trigger type 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.
triggerSource ViConstString Specifies the trigger source. The driver uses this value to set the IVISCOPE_ATTR_TRIGGER_SOURCE attribute.
level ViReal64 Specifies the Trigger Level. Sets the attribute IVISCOPE_ATTR_TRIGGER_LEVEL.
widthLowThreshold ViReal64 Sets the width triggering low threshold in seconds. The driver uses this value to set the IVISCOPE_ATTR_WIDTH_LOW_THRESHOLD attribute.
widthHighTreshold ViReal64 Sets the width triggering high threshold in seconds. The driver uses this value to set the IVISCOPE_ATTR_WIDTH_HIGH_THRESHOLD attribute.
widthPolarity ViInt32 Sets the width polarity. The driver uses this value to set the IVISCOPE_ATTR_WIDTH_POLARITY attribute.
widthCondition ViInt32 Specifies whether a pulse that is within or outside thresholds specified by you triggers waveform acquisition. The driver uses this value to set the IVISCOPE_ATTR_WIDTH_CONDITION attribute.

Return Values