Returns a single measurement based on the specified measurement type.
CalScopeMeasure (hHandle, nChannel, iType, lApplySetup, dTimeout, pdMeasurement, plStatus)
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. |
The function captures waveforms and returns a single measurement based on the specified measurement type.
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);
CalScopeSetupAuto, CalScopeGetInfo, CalScopeReset, CalScopeSetupAcquisition, CalScopeSetupChannel, CalScopeSetupHorizontal, CalScopeGetError