Agilent 4155B/4156B VXIplug&play Driver User’s Guide, Edition 4
2-23
Driver Functions
hp4156b_measureM
hp4156b_measureM
This function executes a multi channel spot measurement by the specified units, and
returns the measured value and the measurement status.
The array size of all arrays should be the same together. Then 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 the measured data and
status data of the units specified by channel[1] will be returned by value[1] and
status[1], respectively.
Syntax
ViStatus _VI_FUNC hp4156b_measureM(ViSession vi, ViInt32 channel[ ],
ViInt32 mode[ ], ViReal64 range[ ], ViReal64 value[ ], ViInt32 status[ ] );
Parameters
vi
Instrument handle returned from hp4156b_init( ).
channel[ ]
Channel number of the measurement unit. Enter 0 (zero) at the
end of the unit definition for channel[ ]. For example, if you use
two units, the first and second elements of channel[ ] must
specify the units, and the third element must be 0.
1 to 6 (SMU1 to SMU6), 23 (VMU1), or 24 (VMU2).
mode[ ]
Measurement mode.
1 (current measurement) 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.
value[ ]
Measurement data.
status[ ]
Measurement status. 0 (no error), or 1 to 255 (error status).