2-28
Agilent 4155B/4156B VXIplug&play Driver User’s Guide, Edition 4
Driver Functions
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 using the
hp4156b_setSample function. The synchronous dc sources used with the sampling
measurement units are defined by using the hp4156b_addSampleSyncIv function.
And the synchronous pulsed sources used with the sampling measurement units are
defined by using 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).
mode[ ]
Measurement mode. 1 (current measurement, only for SMU) or
2 (voltage measurement).
range[ ]
Measurement range. 0 (auto ranging), positive value (limited
auto ranging), or negative value (fixed range). See below.
For current measurement: -1E-11 to -1.0 A, 1E-11 to 1.0 A,
or 0.
For voltage measurement: -2.0 to -200.0 V, 2.0 to 200.0 V
(-0.2 and 0.2 are available for
VMU in differential mode), or 0.
point
Number of measurement points. 1 to 10001.
index[ ]
Measurement data index.
value[ ]
Measurement data.
status[ ]
Measurement status. 0 (no error), or 1 to 255 (error status).
