Returns the board calibration information.
GxCntGetCalibrationInfo (nHandle, pszCalibrationInfo, nInfoMaxLen, pnDaysUntilExpire, pnStatus)
Name |
Type |
Description |
nHandle |
SHORT |
Handle to a counter board. |
pszCalibrationInfo |
PSTR |
Buffer to contain the returned board info (null terminated) string. |
nInfoMaxLen |
SHORT |
Size of the buffer to contain the calibration information string. |
pnDaysUntilExpire |
PSHORT |
Returns the number of days until or from expiration, if number is > 0 then calibration is current otherwise past due. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The returned board’s calibration information has the following fields separated by carriage return and line feed characters ("\r\n"):
Model: model number, e.g. “GTX2230”
Serial Number: serial number, e.g. 216
Control Number: Marvin Test Solutions control number, e.g. “*-CH-CB-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.
Calibration License: Can be either “Installed” with the calibration license number or “Not Installed”.
The following example returns the board’s calibration information string:
SHORT nStatus;
char szCalibrationInfo[1024];
BOOL bExpired;
GxCntGetCalibrationInfo(nHandle, szCalibrationInfo, sizeof szCalibrationInfo, &bExpired,&nStatus);
szCalibrationInfo string printout:
Model: GTX2230
Serial Number: 216
Control Number: *-CH-CB-0
Production Calibration Date: Wed Oct 24 12:30:25 2007
Calibration Date: Wed Oct 24 12:31:58 2007
Recommended Interval: 1 year
Next Calibration Date: Fri Oct 24 12:31:58 2008
Status: Expired (891 days past expiration)
Calibration License: Installed license number 3