User`s guide

2-28 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1

Driver Functions

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).