CalScopeMeasure

Purpose

Returns a single measurement based on the specified measurement type.

Syntax

CalScopeMeasure (hHandle, nChannel, iType, lApplySetup, dTimeout, pdMeasurement, plStatus)

Parameters

Name
Type
Comments
hHandle
LONG
Handle for a Oscilloscope.
nChannel
SHORT
Select channel (0-based).
iType
LONG
Set the type of measurement:
0.      aScopeMeasureAcRms: Returns the captured waveform AC RMS.
1.      aScopeMeasurePeakToPeak: Returns the captured waveform Peak-To-Peak.
2.    aScopeMeasureAmplitude: Returns the captured waveform Amplitude.
lApplySetup
LONG
0.      The function will use current measurements setup.
1.    The function will apply all necessary measurement setup to the current captured waveform for optimal measurement.
dTimeout
DOUBLE
Measurement timeout.
pdMeasurement
PDOUBLE
Returned measurement value.
plStatus
PLONG
Returned status: 0 on success, negative number on failure.

Comments

The function captures waveforms and returns a single measurement based on the specified measurement type.

Example

The following example read a single AC RMS measurement from channel 0, while reapplying measurement setup to the input signal:

 

LONG   lHandle, lStatus;

DOUBLE dMeasurement;

 

CalScopeMeasure (lHandle, 0, aScopeMeasureAcRms, 1, 30, &dMeasurement, &lStatus);

 

See Also

CalScopeSetupAuto, CalScopeGetInfo, CalScopeReset, CalScopeSetupAcquisition, CalScopeSetupChannel, CalScopeSetupHorizontal, CalScopeGetError