Agilent 4155B/4156B VXIplug&play Driver User’s Guide, Edition 4
2-29
Driver Functions
hp4156b_self_test
Remarks
The array size of the parameters should be as shown below.
ViInt32 channel[N]
ViInt32 mode[N]
ViReal64 range[N]
ViInt32 point
ViInt32 index[M]
ViReal64 value[M][N]
ViReal64 status[M][N]
where,
N: Number of channels used for the measurements plus 1, or more.
M: Number of sweep points ('point’ parameter value of hp4156b_setSample
function), or more.
For the parameter definition, the order of the array data is important. For example,
the measurement setup for the unit specified by channel[1] must be entered into
mode[1] and range[1]. And measurement data and status data of the unit specified
by channel[1] will be returned by value[M][1] and status[M][1], respectively.
hp4156b_self_test
This function causes the instrument to perform a self-test and returns the result of
that self-test. This is used to verify that an instrument is operating properly. A failure
may indicate a potential hardware problem.
Syntax
ViStatus _VI_FUNC hp4156b_self_test(ViSession vi, ViPInt16 test_result,
ViChar_VI_FAR test_message[ ] );
Parameters
vi
Instrument handle returned from hp4156b_init( ).
test_result
Numeric result from self-test operation. 0: No error.
test_message[ ]
Self-test status message. This is limited to 256 characters.
