GxCntReadMeasurement

Purpose

Read a single measurement.

Syntax

GxCntReadMeasurement (nHandle, pdMeasurement, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a counter board.
pdMeasurement
PDOUBLE
Returned measurement.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

This function is for reading measurement results out of the board. If a result is available it is returned immediately, otherwise the function will wait for a measurement to become available. Use GxCntIsMeasurementReady to prevent the software from “hanging up” if the signal is lost or for slow signals in order to ensure that measurement data is ready before attempting to read.

Note: A measurement value that is equal to –1 indicates that the measurement value is out of the board’s measuring range, e.g. measuring a value of 1.4GHz using a GC2220/GTX2220.

Example

The following example read a single measurement:

 

SHORT nHandle, nStatus;

DOUBLE dMeasurement;

GxCntReadMeasurement (nHandle, &dMeasurement, &nStatus);

 

See Also

GxCntReadMeasurementArray, GxCntIsMeasurementReady, GxCntReadMeasurementString, GxCntReadStatusRegister, GxCntGetFunction, GxCntGetErrorString