ClassPrefix Get Next Interchange Warning
IVI Inherent Function
To form the ClassPrefix VI name, use the prefix of the class driver that you are working with. For example, if you are working with the IviDmm class driver, use the prefix IviDmm to create the correct VI name, IviDmm Get Next Interchange Warning.
This VI returns the interchangeability warnings associated with the IVI session. It retrieves and clears the oldest instance in which the class driver recorded an interchangeability warning. Interchangeability warnings indicate that using your application with a different instrument might cause different behavior. Use this VI to retrieve interchangeability warnings. Alternately, you may use NI I/O Trace to view interchangeability warnings.
Interchangeability checking examines the properties in a capability group only if you specify a value for at least one property within that group. In general, the class driver generates interchangeability warnings when it encounters one of the following conditions:
- A property that affects the behavior of the instrument is in a state that you did not specify.
- You set a class-defined property to an instrument specific value.
- You set the value of a property that the class driver defines as read-only.
- The class driver encounters an error when it tries to apply a value to an extension property that your program never configures.
 |
instrument handle The instrument handle that you obtain from the ClassPrefix Initialize or ClassPrefix Initialize With Options VI. The handle identifies a particular instrument session. |
 |
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
 |
instrument handle out The instrument handle that you obtain from the ClassPrefix Initialize or ClassPrefix Initialize With Options VI. The handle identifies a particular instrument session. |
 |
interchange warning Returns the next interchange warning for the IVI session. If there are no interchange warnings, this parameter returns an empty string. |
 |
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |