Attributes for Status Simulation in IviScope

When an IviScope driver function is called, the driver queries whether NISSCOPE_ATTR_SIMULATE_STATUS_CODE is enabled. If enabled, the driver gets the appropriate function's simulation status code. If the value of the simulation status code represents a warning (has a positive value), then it is returned as the function's return status only if no other error or warning occurred before the function ends. If the value of the simulation status code represents an error (has a negative value), then it is returned as the function's return status only if no other error occurred before the function ends.

The following IviScope functions do not support status code simulation:

• IviScope_GetError
• IviScope_ClearError
• IviScope_GetNextInterchangeWarning
• IviScope_ResetNextInterchangeWarning
• IviScope_ClearNextInterchangeWarning
• IviScope_GetNextCoercionRecord
• IviScope_LockSession
• IviScope_UnlockSession
• IviScope_CheckAttribute
• IviScope_GetAttribute
• IviScope_SetAttribute

Each function supported by the IviScope class driver has a corresponding attribute that determines the status code to return when status code simulation is enabled. The following list indicates the status code attributes and the function for which they return a value. These attributes are all of type ViInt32, non-readable, and non-channel based.

Note  In the following table, the literal string NISSCOPE_ATTR_ precedes all attribute names.

IviScope Attributes for Status Simulation

Attribute	Function
INIT_STATUS	IviScope_init, IviScope_InitWithOptions
CLOSE_STATUS	IviScope_close
RESET_STATUS	IviScope_reset
SELF_TEST_STATUS	IviScope_self_test
ERROR_QUERY_STATUS	IviScope_error_query
ERROR_MESSAGE_STATUS	IviScope_error_message
REVISION_QUERY_STATUS	IviScope_revision_query
RESET_DEFAULT_STATUS	IviScope_ResetWithDefaults
DISABLE_STATUS	IviScope_Disable
INVALIDATE_STATUS	IviScope_InvalidateAllAttributes
GET_CH_NAME_STATUS	IviScope_GetChannelName
CONFIGURE_CHANNEL_STATUS	IviScope_ConfigureChannel
CONFIGURE_CHAN_CHARACTERISTICS_STATUS	IviScope_ConfigureChanCharacteristics
CONFIGURE_ACQUISITION_TYPE_STATUS	IviScope_ConfigureAcquisitionType
CONFIGURE_ACQUISITION_RECORD__STATUS	IviScope_ConfigureAcquisitionRecord
ACTUAL_RECORD_LENGTH_STATUS	IviScope_ActualRecordLength
CONFIGURE_TRIGGER_STATUS	IviScope_ConfigureTrigger
CONFIGURE_TRIGGER_COUPLING_STATUS	IviScope_ConfigureTriggerCoupling
CONFIGURE_EDGE_TRIGGER_SOURCE_STATUS	IviScope_ConfigureEdgeTriggerSource
READ_WAVEFORM_STATUS	IviScope_ReadWaveform
ABORT_STATUS	IviScope_Abort
INITIATE_ACQUISITION_STATUS	IviScope_InitiateAcquisition
ACQUISITION_STATUS_STATUS	IviScope_AcquisitionStatus
FETCH_WAVEFORM_STATUS	IviScope_FetchWaveform
IS_INVALID_WFM_ELEMENT_STATUS	IviScope_IsInvalidWfmElement
CONFIGURE_TV_TRIGGER_SOURCE_STATUS	IviScope_ConfigureTVTriggerSource
CONFIGURE_TV_TRIGGER_LINE_NUMBER_ STATUS	IviScope_ConfigureTVTriggerLineNumber
CONFIGURE_RUNT_TRIGGER_SOURCE_STATUS	IviScope_ConfigureRuntTriggerSource
CONFIGURE_GLITCH_TRIGGER_SOURCE_ STATUS	IviScope_ConfigureGlitchTriggerSource
CONFIGURE_WIDTH_TRIGGER_SOURCE_STATUS	IviScope_ConfigureWidthTriggerSource
CONFIGURE_AC_LINE_TRIGGER_SLOPE_ STATUS	IviScope_ConfigureAcLineTriggerSlope
CONFIGURE_TRIGGER_MODIFIER_STATUS	IviScope_ConfigureTriggerModifier
CONFIGURE_NUM_ENVELOPES_STATUS	IviScope_ConfigureNumEnvelopes
READ_MIN_MAX_WAVEFORM_STATUS	IviScope_ReadMinMaxWaveform
FETCH_MIN_MAX_WAVEFORM_STATUS	IviScope_FetchMinMaxWaveform
CONFIGURE_REF_LEVELS_STATUS	IviScope_ConfigureRefLevels
READ_WAVEFORM_MEASUREMENT_STATUS	IviScope_ReadWaveformMeasurement
FETCH_WAVEFORM_MEASUREMENT_STATUS	IviScope_FetchWaveformMeasurement
CONFIGURE_NUM_AVERAGES_STATUS	IviScope_ConfigureNumAverages
CONFIGURE_INITIATE_CONTINUOUS_STATUS	IviScope_ConfigureInitiateContinuous
CONFIGURE_INTERPOLATION_STATUS	IviScope_ConfigureInterpolation
SAMPLE_MODE_STATUS	IviScope_SampleMode
SAMPLE_RATE_STATUS	IviScope_SampleRate
AUTO_PROBE_SENSE_VALUE_STATUS	IviScope_AutoProbeSenseValue
AUTO_SETUP_STATUS	IviScope_AutoSetup