niDMM_ConfigureMeasurementAbsolute

NI-DMM C/CVI/VB

niDMM_ConfigureMeasurementAbsolute

ViStatus = niDMM_ConfigureMeasurementAbsolute(ViSession Instrument_Handle, ViInt32 Measurement_Function, ViReal64 Range, ViReal64 Resolution_Absolute)

Purpose

Configures the common attributes of the measurement. These attributes include NIDMM_ATTR_FUNCTION, NIDMM_ATTR_RANGE, and NIDMM_ATTR_RESOLUTION_ABSOLUTE.

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Measurement_Function ViInt32 Specifies the Measurement_Function used to acquire the measurement. The driver sets NIDMM_ATTR_FUNCTION to this value.
Range ViReal64 Specifies the Range for the function specified in the Measurement_Function parameter. When frequency is specified in the Measurement_Function parameter, you must supply the minimum frequency expected in the Range parameter. For example, you must type in 100 Hz if you are measuring 101 Hz or higher.

For all other functions, you must supply a Range that exceeds the value that you are measuring. For example, you must type in 10 V if you are measuring 9 V. Range values are coerced up to the closest input Range. Refer to the Devices Overview for a list of valid ranges. The driver sets NIDMM_ATTR_RANGE to this value. The default is 0.02 V.

Note  The NI 4050, NI 4060, and NI 4065 only support Auto Range when the trigger and sample trigger are set to IMMEDIATE.

NIDMM_VAL_AUTO_RANGE_ON -1.0 NI-DMM performs an Auto Range before acquiring the measurement.
NIDMM_VAL_AUTO_RANGE_OFF -2.0 NI-DMM sets the Range to the current NIDMM_ATTR_AUTO_RANGE_VALUE and uses this range
for all subsequent measurements until the measurement configuration is changed.
NIDMM_VAL_AUTO_RANGE_ONCE -3.0 NI-DMM performs an Auto Range before acquiring the measurement. The NIDMM_ATTR_AUTO_RANGE_VALUE is stored and used for all subsequent measurements until the measurement configuration is changed.
Resolution_Absolute ViReal64 Specifies the absolute resolution for the measurement. NI-DMM sets NIDMM_ATTR_RESOLUTION_ABSOLUTE to this value. This parameter is ignored when the Range parameter is set to NIDMM_VAL_AUTO_RANGE_ON (-1.0) or NIDMM_VAL_AUTO_RANGE_ONCE (-3.0). The default is 0.001 V.

Note  NI-DMM ignores this parameter for capacitance and inductance measurements on the NI 4072. To achieve better resolution for such measurements, use the NIDMM_ATTR_LC_NUMBER_MEAS_TO_AVERAGE attribute.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_error_message. To obtain additional information concerning the error condition, use niDMM_GetError.