niDMM_ConfigureWaveformAcquisition

NI-DMM C/CVI/VB

niDMM_ConfigureWaveformAcquisition

ViStatus = niDMM_ConfigureWaveformAcquisition(ViSession Instrument_Handle, ViInt32 Measurement_Function, ViReal64 Range, ViReal64 Rate, ViInt32 Waveform_Points)

Purpose

Configures the NI 4070/4071/4072 for waveform acquisitions.

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 in a waveform acquisition. The driver sets NIDMM_ATTR_FUNCTION to this value.

NIDMM_VAL_WAVEFORM_VOLTAGE (default) 1003 Voltage Waveform
NIDMM_VAL_WAVEFORM_CURRENT 1004 Current Waveform
Range ViReal64 Specifies the expected maximum amplitude of the input signal and sets the Range for the Measurement_Function. NI-DMM sets NIDMM_ATTR_RANGE to this value. Range values are coerced up to the closest input Range. The default is 10.0.

For valid ranges refer to the topics in Devices.

Auto-ranging is not supported during waveform acquisitions.

Rate ViReal64 Specifies the Rate of the acquisition in samples per second. NI-DMM sets NIDMM_ATTR_WAVEFORM_RATE to this value.

The valid Range is 10.0–1,800,000 S/s. Rate values are coerced to the closest integer divisor of 1,800,000. The default value is 1,800,000.

Waveform_Points ViInt32 Specifies the number of points to acquire before the waveform acquisition completes. NI-DMM sets NIDMM_ATTR_WAVEFORM_POINTS to this value.

To calculate the maximum and minimum number of waveform points that you can acquire in one acquisition, refer to the Waveform Acquisition Measurement Cycle.

The default value is 500.

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.