Attributes for Status Simulation in IviSwtch
When an IviSwtch driver function is called, the driver queries whether NISSWTCH_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 IviSwtch functions do not support status code simulation:
- IviSwtch_GetError
- IviSwtch_ClearError
- IviSwtch_GetNextInterchangeWarning
- IviSwtch_ResetNextInterchangeWarning
- IviSwtch_ClearNextInterchangeWarning
- IviSwtch_GetNextCoercionRecord
- IviSwtch_LockSession
- IviSwtch_UnlockSession
- IviSwtch_CheckAttribute
- IviSwtch_GetAttribute
- IviSwtch_SetAttribute
Each function supported by the IviSwtch class driver has a corresponding attribute that determines the status code to return when status code simulation is enabled. The following table lists 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 NISSWTCH_ATTR_ precedes all attribute names. |