IviScope Interchangeability
The IviScope class driver performs interchangeability checking when the IVISCOPE_ATTR_INTERCHANGE_CHECK attribute is set to VI_TRUE and you call one of the following functions:
IviScope_ReadWaveformMeasurement
IviScope_FetchWaveformMeasurement
In addition to the general interchangeability checking rules, the IviScope class defines additional rules and exceptions for each capability group.
| IviScopeBase | The IVISCOPE_ATTR_TRIGGER_LEVEL attribute must be in a user-specified state only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_EDGE_TRIGGER or IVISCOPE_VAL_RUNT_TRIGGER. |
| IviScopeTVTrigger | The driver performs interchangeability checking on the IviScopeTVTrigger group only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_TV_TRIGGER.
The IVISCOPE_ATTR_TV_TRIGGER_LINE_NUMBER attribute must be in a user-specified state only if the application sets the IVISCOPE_ATTR_TV_TRIGGER_EVENT attribute to IVISCOPE_VAL_TV_EVENT_LINE_NUMBER. |
| IviScopeRuntTrigger | The driver performs interchangeability checking on the IviScopeRuntTrigger group only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_RUNT_TRIGGER. |
| IviScopeGlitchTrigger | The driver performs interchangeability checking on the IviScopeGlitchTrigger group only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_GLITCH_TRIGGER. |
| IviScopeWidthTrigger | The driver performs interchangeability checking on the IviScopeWidthTrigger group only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_WIDTH_TRIGGER. |
| IviScopeAcLineTrigger | The driver performs interchangeability checking on the IviScopeAcLineTrigger group only if the application sets the IVISCOPE_ATTR_TRIGGER_TYPE attribute to IVISCOPE_VAL_AC_LINE_TRIGGER. |
| IviScopeWaveformMeas | The IVISCOPE_ATTR_MEAS_LOW_REF attribute must be in a user-specified state if you request a waveform measurement that requires the low reference level, such as rise time, fall time, preshoot and overshoot.
The IVISCOPE_ATTR_MEAS_MID_REF attribute must be in a user-specified state if you request a waveform measurement that requires the middle reference level, such as frequency, period, positive and negative pulse widths, and all cycle-based measurements. The IVISCOPE_ATTR_MEAS_HIGH_REF attribute must be in a user-specified state if the user requests a waveform measurement that requires the high reference level, such as rise time, fall time, preshoot and overshoot. |
| IviScopeMinMax Waveform |
The driver performs interchangeability checking on the IviScopeMinMaxWaveform group only if the application sets the IVISCOPE_ATTR_ACQUISITION_TYPE attribute to IVISCOPE_VAL_ENVELOPE or IVISCOPE_VAL_PEAK_DETECT.
The IVISCOPE_ATTR_NUM_ENVELOPES attribute must be in a user-specified state only if the application sets the IVISCOPE_ATTR_ACQUISITION_TYPE attribute to IVISCOPE_VAL_ENVELOPE. |
| IviScopeContinuous Acquisition |
Using this extension group is inherently non-interchangeable. This specification does not define the behavior of the instrument nor the data the instruments return while continuously acquiring the data. |
| IviScopeAverage Acquisition |
The driver performs interchangeability checking on the IviScopeAverageAcquisition group only if the application sets the IVISCOPE_ATTR_ACQUISITION_TYPE attribute to IVISCOPE_VAL_AVERAGE. |
| IviScopeAutoSetup | Using this extension group is inherently non-interchangeable. The application behavior then depends on the internal instrument's algorithms for optimal acquisition and channel configuration. |
The IviScope class does not define additional interchangeability rules or exceptions for the following extension capability groups: IviScopeBase, IviScopeProbeAutoSense, IviScopeSampleMode, IviScopeInterpolation, and IviScopeTriggerModifier.