Returns a result from measurement that has already occurred
GxDmmRead (nHandle, pdMeasurement, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Handle for a GX2065 board. |
pdMeasurement |
PDOUBLE |
Return the measurement |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure, positive number on warning. |
This function reads back the result from a measurement that has already occurred. The result is returned without normalizing in base units. For example, Voltage will be returned as Volts, Current will be returned as Amps, Resistance will be returned as Ohms, Temperature will be returned as degrees Celsius, and Frequency will be returned as Hertz.
Note that this function does not initiate a new measurement. To initiate a new single reading through software, call GxDmmMeasure, GxDmmMeasureEx, or GxDmmTrig.
The parameter pdMeasurement will be set to 0 if an error occurs.
If an overflow warning (GXDMM_WARNING_OVERFLOW) has occurred, pdMeasurement will be set to GXDMM_OVERFLOW_MEASUREMENT (1000000000000).
If any other warning occurs, pdMeasurement will be set to 0.
The following takes a new measurement:
SHORT nHandle, nStatus;
DOUBLE dMeasurement;
GxDmmRead (nHandle, &dMeasurement, &nStatus);
GxDmmReadEx, GxDmmMeasure, GxDmmMeasureEx, GxDmmSetTriggerMode, GxDmmGetTriggerMode, GxDmmSetRange, GxDmmGetRange, GxDmmSetFunction, GxDmmGetFunction, GxDmmGetErrorString