GxDmmGetCalibrationInfo

Purpose

Returns the calibration information

Syntax

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

Parameters

Name
Type
Comments
nHandle
SHORT

Handle to a DMM board.

pszSummary
PSTR
Buffer to contain the returned board info (null terminated) string.
nSumMaxLen
SHORT
Size of the buffer to contain the error 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.

Comments

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

Model: model number, e.g. “GX2065”

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”.

Example

The following example returns the board’s calibration information string:

 

SHORT nStatus;

char szCalibrationInfo[1024];

BOOL bExpired;

 

GxDmmGetCalibrationInfo(nHandle, szCalibrationInfo, sizeof szCalibrationInfo,

&bExpired,&nStatus);

 

szCalibrationInfo string printout:

Model: GX2065

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

 

See Also

GxDmmInitialize, GxDmmGetBoardSummary, GxDmmGetErrorString