User`s guide

Agilent B1500 VXIplug&play Driver User’s Guide, Edition 3 2-41

Driver Functions

agb1500_sampleIv

This function executes a sampling measurement by the specified channels, and

returns the number of measurement points, measurement data index, measurement

data, measurement status, and time stamp data.

Before this function, execute the agb1500_setSample function to set the sampling

timing and execute the agb1500_setSampleMode function to set the sampling mode.

Also, execute the agb1500_addSampleSyncIv functions to set the synchronous DC

sources used with the sampling measurement channels.

Syntax ViStatus _VI_FUNC agb1500_sampleIv(ViSession vi, ViInt32 channel[ ],

ViInt32 mode[ ], ViReal64 range[ ], ViPInt32 point, ViInt32 index[ ],

ViReal64 value[ ], ViInt32 status[ ], ViReal64 time[ ]);

Parameters vi Instrument handle returned from agb1500_init( ).

channel[ ] Slot number of the slot that installs the SMU to be used. See

Table 2-2.

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

For the linear sampling with interval < 2 msec, only the fixed

range is available. Even if range=0 or positive value is set, the

measurement channels will automatically select and use the

range that covers the compliance value set to each channel.

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-14. To disable the status data output,

set 0 (NULL pointer) instead of array.

time[ ] Time stamp data (measurement start time). Returned data. To

disable the time stamp data output, set 0 (NULL pointer)

instead of array.