GxSmuMeasureGetParamters

Applies To

GX3104, GX3116e

Purpose

Returns the specified channel’s measurement parameters.

Syntax

GxSmuMeasureGetParamters (nHandle, pnApertureType, pdAperture, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3104 or GX3116e board.
pnApertureType
PSHORT

0.      GXSMU_MEASURE_IN_READINGS_PER_SEC: Set the measurement in reading per second

1.      GXSMU_MEASURE_IN_PLC: Set the measurement in Power Line Cycles.

pdAperture
PDOUBLE
Value depends on the nApertureType parameter settings. Capture aperture in terms of Power Line Cycles or in seconds.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The aperture can be expressed in terms of Power Line Cycles as set by the GxSmuMeasureSetPowerLineFrequency function, or in seconds. The Aperture can be a fraction of a line cycle. For example, the aperture can be set to 0.1 Line Cycles which would represent approximately 0.00167 seconds if the Line Frequency was set to 60Hz.

Example

The following example sets measurement parameters:

 

SHORT  nHandle, nStatus, nApertureType;

DOUBLE dAperture;

 

GxSmuMeasureSetParamters (nHandle, GXSMU_MEASURE_IN_READINGS_PER_SEC, 1, &nStatus);

GxSmuMeasureGetParamters (nHandle, &nApertureType, &dAperture, &nStatus);

 

See Also

GxSmuMeasureSetSenseMode, GxSmuMeasureSetPowerLineFrequency, GxSmuMeasure, GxSmuMeasureSetParamters, GxSmuGetErrorString