GtDio6xGetCalibrationInfo

Applies To

GX5296, GX5961, GX5964

Purpose

Returns the calibration information.

Syntax

GtDio6xGetCalibrationInfo (nHandle, pszCalibrationInfo, nInfoMaxLen, pnDaysUntilExpire, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Session identifier:

     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.

pszCalibrationInfo
PSTR
Buffer to contain the returned calibration information (null terminated) string.
nInfoMaxLen
SHORT
Size of the buffer to contain the calibration information string.
pnDaysUntilExpire
PSHORT
Size of the buffer to contain the calibration information string.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The returned board’s calibration information has the following fields:

Model: model number, e.g. “Gx5964 Master”

Serial Number: serial number, e.g. 216

Control Number: Marvin Test Solutions control number, e.g. “*-BA-BA-0”

Production Calibration Date: Wed Oct 24 12:30:25 2010

Calibration Date: Wed Oct 24 12:31:58 2010

Recommended Interval: 1 year

Next Calibration Date: Fri Oct 24 12:31:58 2011

Status: calibration status can be either “Expired” followed by the number of days past expiration or “Current” followed by number of days until expire.

Example

The following example returns the board summary:

 

SHORT nDaysUntilExpire, nHandle, nStatus;

CHAR szCalibrationInfo [1024];

 

GtDio6xGetCalibrationInfo(nHandle, szCalibrationInfo, sizeof(szCalibrationInfo), 1024, &nDaysUntilExpire &nStatus);

See Also

GtDio6xGetBoardSummary, GtDio6xGetDriverSummary, GtDio6xGetErrorString