GxDmmMeasure

Purpose

Takes a measurement and return the result

Syntax

GxDmmMeasure (nHandle, pdMeasurement, pnStatus)

Parameters

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.

Comments

This function generates a software trigger and forces the DMM to take a measurement. 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.

If the DMM is in continuous trigger mode when this function is called, the DMM will switch to software trigger mode before taking a measurement.

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.

NOTE: When measuring the resistance of open circuit in 2-Wire and 4-Wire modes, the measurement time is less than 1mSec regardless of the resolution and aperture settings.

Example

The following takes a new measurement:

 

SHORT nHandle, nStatus;

DOUBLE dMeasurement;

GxDmmMeasure (nHandle, &dMeasurement, &nStatus);

 

See Also

GxDmmMeasureEx, GxDmmRead, GxDmmReadEx, GxDmmSetTriggerMode, GxDmmGetTriggerMode, GxDmmSetRange, GxDmmGetRange, GxDmmSetFunction, GxDmmGetFunction, GxDmmGetErrorString