AMETEK Ls Series Driver Manual - Manual (Page 229)

IVI Driver Manual Lx / Ls Series
225
ciLxs_ResetInterchangeCheck
ViStatus ciLxs_ResetInterchangeCheck (ViSession instrumentHandle);
Purpose
When developing a complex test system that consists of multiple test
modules, it is generally a good idea to design the test modules so that
they can run in any order. To do so requires ensuring that each test
module completely configures the state of each instrument it uses. If a
particular test module does not completely configure the state of an
instrument, the state of the instrument depends on the configuration from
a previously executed test module. If you execute the test modules in a
different order, the behavior of the instrument and therefore the entire
test module is likely to change. This change in behavior is generally
instrument specific and represents an interchangeability problem.
You can use this function to test for such cases. After you call this
function, the interchangeability checking algorithms in the specific
driver ignore all previous configuration operations. By calling this
function at the beginning of a test module, you can determine whether the
test module has dependencies on the operation of previously executed test
modules.
This function does not clear the interchangeability warnings from the
list of previously recorded interchangeability warnings. If you want to
guarantee that the ciLxs_GetNextInterchangeWarning function only returns
those interchangeability warnings that are generated after calling this
function, you must clear the list of interchangeability warnings. You
can clear the interchangeability warnings list by repeatedly calling the
ciLxs_GetNextInterchangeWarning function until no more interchangeability
warnings are returned. If you are not interested in the content of those
warnings, you can call the ciLxs_ClearInterchangeWarnings function.
Parameter List
instrumentHandle
Variable Type ViSession
The ViSession handle that you obtain from the ciLxs_init or
ciLxs_InitWithOptions function. The handle identifies a particular
instrument session.
Default Value: None
Return Value
Returns the status code of this operation. The status code either
indicates success or describes an error or warning condition. You
examine the status code from each call to an instrument driver
function to determine if an error occurred.
To obtain a text description of the status code, call the
ciLxs_error_message function. To obtain additional information about