2-30 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 4
Driver Function Reference
hp4156b_sample
hp4156b_sample
This function executes a sampling measurement by the specified channels, and
returns the number of measurement points, measurement data index, measurement
data, and the measurement status.
Before executing this function, set the sampling timing by the hp4156b_setSample
function. The synchronous dc sources used with the sampling measurement units are
defined by the hp4156b_addSampleSyncIv function. And the synchronous pulsed
sources used with the sampling measurement units are defined by the
hp4156b_addSampleSyncPulse function.
Syntax ViStatus _VI_FUNC hp4156b_sample(ViSession vi, ViInt32 channel[ ],
ViInt32 mode[ ], ViReal64 range[ ], ViPInt32 point, ViInt32 index[ ],
ViReal64 value[ ], ViInt32 status[ ]);
Parameters vi Instrument handle returned from hp4156b_init( ).
channel[ ] Channel number of the measurement unit. 1 to 6 (SMU1 to
SMU6), 23 (VMU1), or 24 (VMU2).
Enter 0 to the last element of channel[ ]. For example, if you use
two channels, set the array size to 3, specify the channels to the
first and second elements, and enter 0 to the third element.
mode[ ] Measurement mode. 1 (current, only for SMU) or 2 (voltage).
range[ ] Measurement ranging mode. 0 (auto), positive value (limited
auto), or negative value (fixed range). For the available values,
see Table 2-2 and Table 2-5 or Table 2-7.
point Number of measurement points. Returned data.
index[ ] Measurement data index. Returned data.
value[ ] Measurement data. Returned data.
status[ ] Measurement status. Returned data. For the status value, see
“Status Code” on page 2-12.
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.