niDMM_ConfigureFrequencyVoltageRange

NI-DMM C/CVI/VB

niDMM_ConfigureFrequencyVoltageRange

ViStatus = niDMM_ConfigureFrequencyVoltageRange(ViSession Instrument_Handle, ViReal64 Voltage_Range)

Purpose

For the NI 4070/4071/4072 only, specifies the expected maximum amplitude of the input signal for frequency and period measurements.

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.
Voltage_Range ViReal64 Sets the expected maximum amplitude of the input signal. Refer to the NI 4070, NI 4071, and NI 4072 sections for a list of valid values. NI-DMM sets NIDMM_ATTR_FREQ_VOLTAGE_RANGE to this value. The minimum peak-to-peak signal amplitude that can be detected is 10% of the specified Voltage_Range.

NameValueDescription
NIDMM_VAL_AUTO_RANGE_ON (default) -1.0 Configures the DMM to take an Auto Range measurement to calculate the voltage range before each frequency or period measurement.
NIDMM_VAL_AUTO_RANGE_OFF -2.0 Disables Auto Ranging. The driver sets the voltage range to the last calculated voltage range.

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.