beautypg.com

Getrangelist, Initialization functions, Loaddriver – Dataman 570 Series User Manual

Page 14: Parameters

background image


Development kit for DATAMAN 570 series

Programmer’s Guide

nsPerDiv – amount of nanoseconds per screen division (50 samples); this

value is passed to the SetTimeBase function

RealSamplingRate – real sampling rate (in case, that the timebase doesn’t run

in sampling mode, this value equals to SamplingRate)

SamplingRate – equivalent sampling rate; this frequency determines distance

between two samples

SamplingMulti – indicates ratio of SamplingRate and RealSamplingRate; the

value of 1 indicates sampling in real time, value greater than 1 indicates sampling
mode

3.1.7. GetRangeList

Returns the list of available ranges.

void __declspec(dllimport) __stdcall GetRangeList(TRangeItem *RangeList,

int *RangeListLength);

Parameters:

rangelist – the first item of the array which will be filled with the available

ranges. Array must be at least 13 items long.

rangelistlength – the number of array items which was filled (number of

available ranges)

Return value: -

Remark:
Each array item is of TRangeItem type. This structure comprise of following items:

mVPerDiv – amount of mV per one screen division (32 quantization levels);

this value is passed to the SetRange function

3.2. Initialization functions

3.2.1. LoadDriver

Loads m570drv.dll driver.

int __declspec(dllimport) __stdcall LoadDriver();


Parameters: -

Return value:

ERROR_OK – driver loaded successfully

ERROR_DRIVER_NOT_LOADED – unable to load m570drv.dll library

ERROR_DRIVER_INCOMPATIBLE – m570drv.dll isn’t compatible with DK


Remark:
The return value is stored in the internal DK variable as well. Use GetDKError
function to access this internal variable.

- 14 -