GxCntGetAcquisitionTimeInterval

Purpose

Returns the board Acquisition Time Interval.

Syntax

GxCntGetAcquisitionTimeInterval (nHandle, pdSeconds, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a counter board.
pdSeconds
PDOUBLE
Returned acquisition time interval in seconds, interval range. Intervals can be set from 0.8 ms to 3200 seconds.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

When setting the acquisition mode to Paced mode (see GxCntSetAcquisitionMode function) the GTX22x0ensures the acquisition of data at accurately spaced time intervals. In Paced operation, the user specifies the time which should elapse BETWEEN the initiations of measurements. The pace times are digitally generated on the GTX22x0 and are accurate to within 200 µS (the errors do not accumulate).

Some care must be used when selecting pacing intervals to ensure consistent timing between measurements. The Acquisition interval must be at least 600 µS, longer than the actual gate time in Frequency and Period modes and 600 µS longer than the actual measurement interval in timing modes (e.g: Pulse Width). If these recommendations are not followed, the counter will simply “skip” measurements, and the data will be taken at uneven intervals. If skipping occurs in Acquire mode the function returns an error.

Example

The following example returns the Acquisition time interval:

 

SHORT nHandle, nStatus;

DOUBLE dSeconds

GxCntGetAcquisitionTimeInterval (nHandle, &dSeconds, &nStatus)

 

See Also

GxCntSetAcquisitionTimeInterval, GxCntSetAcquisitionMode, GxCntGetAcquisitionMode, GxCntGetErrorString