GxCntSetMeasurementNumberOfDigits

Purpose

Sets the measurement number of digits and mode.

Syntax

GxCntSetMeasurementNumberOfDigits (nHandle, nMode, nMaxDigits, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a counter board.
nMode
SHORT
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.
nMaxDigits
SHORT
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 sets the measurement number of digits to 13 and sets the mode:

 

GxCntSetMeasurementNumberOfDigits(nHandle, GXCNT_MEASURE_NUM_OF_DIGITS_FIXED, 13, &nStatus)

 

See Also

GxCntGetMeasurementNumberOfDigits, GxCntSetMeasurementTimeout, GxCntGetFunction, GxCntGetErrorString