GxCalGetFunctionStoredMeasuredValue

Purpose

Returns the specified function stored measured values.

Syntax

GxCalGetFunctionStoredMeasuredValue (nHandle, nFunction, dValue1, dValue2, pdValue1, pdValue2, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX1034 board.
nFunction
SHORT
Function numbers (see comments for details):
GXCAL_FUNCTION_NOT_CONNECTED: No function connected.
GXCAL_FUNCTION_4WIRE: 4-wires resistors connected.
GXCAL_FUNCTION_2WIRE: 2-wires resistors connected.
GXCAL_FUNCTION_POSITIVE_VDC: Positive DC voltage connected.
GXCAL_FUNCTION_NEGATIVE_VDC: Negative DC voltage connected.
GXCAL_FUNCTION_AC: AC voltage connected.
dValue1
DOUBLE
Function value 1, see comments
dValue2
DOUBLE
Function value 2, see comments
pdValue1
PDOUBLE
Returned value 1, see comments
pdValue2
PDOUBLE
Returned value 2, see comments
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Returns the specified function stored measured values are as follow:

Connected function: 4-wires resistors (GXCAL_FUNCTION_4WIRE):

There are three 4-wire resistors on-board of 1W, 10W, 100W. Actual measured values are stored in the on-board EEPORM.

Connected function: 2-wires resistors (GXCAL_FUNCTION_2WIRE):

There are eight 2-wire resistors on-board of 1W, 10W, 100W, 1KW, 10KW, 100KW, 1MW, 10MW. Actual measured values are stored in the on-board EEPORM.

Connected function: Positive DC voltage (GXCAL_FUNCTION_POSITIVE_VDC):

There are four positive DC voltages on-board of 9.0V, 0.9V, 0.09V, 0.009V. Actual measured values are stored in the on-board EEPORM.

Connected function: Negative DC voltage (GXCAL_FUNCTION_NEGATIVE_VDC):

There are four negative DC voltages on-board of -9.0V, -0.9V, -0.09V, -0.009V. Actual measured values are stored in the on-board EEPORM.

Connected function: AC voltage (GXCAL_FUNCTION_AC):

The supported AC frequncies are 100Hz, 1KHz, 10KHz, 100KHz, 50Hz, 60Hz and 400Hz. Actual measured values are stored in the on-board EEPORM.

Note: This function allows the user to retrieve all the actual (measured) values for each function.

Example

The following example returns the stored valuefor 9.0V VDCs:

 

SHORT nHandle, nFunction, nStatus;

DOUBLE dValue1, dValue2;

GxCalGetFunction (nHandle, GXCAL_FUNCTION_POSITIVE_VDC , 9.0, 0.0,  &dValue1, &dValue2, &nStatus);

 

See Also

GxCalSetFunction, GxCalMesure, GxCalGetErrorString