GxCntGetMeasurementNumberOfDigits

Purpose

Returns the measurement number of digits and mode.

Syntax

GxCntGetMeasurementNumberOfDigits (nHandle, pnMode, pnMaxDigits, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a counter board.
pnMode
PSHORT
Measurement number of digits modes are:
  1. GXCNT_MEASURE_NUM_OF_DIGITS_AUTO: the counter automatically sets the number of digits according to the gate time.
  2. GXCNT_MEASURE_NUM_OF_DIGITS_FIXED: user overrides the counter’s automatic measure number of digits settings, all measurement will have the same number of digits as was set by the nMaxDigits parameter.
pnMaxDigits
PSHORT
If Measurement number of digits mode was set to GXCNT_MEASURE_NUM_OF_DIGITS_AUTO: returns the last completed measurements number of digits as was set internally by the counter.
If Measurement number of digits mode was set to GXCNT_MEASURE_NUM_OF_DIGITS_FIXED: returns the users specified number of digits. Number of digits can be between 5 to 14
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function allows the use to either format the returned measurement value to a specified number of digits or increase the total number of digits when taking measurements with long gate time in order to get more then maximum 11 digits.

Note: Gx2210 and GC2210 will not support number of digits greater than 9.

Example

The following example returns measurement number of digits and mode settings:

 

SHORT nMode, nMaxDigits;

GxCntGetMeasurementNumberOfDigits(nHandle, &nMode, &nMaxDigits, &nStatus)

 

See Also

GxCntSetMeasurementNumberOfDigits, GxCntSetMeasurementTimeout, GxCntGetFunction