niDMM Configure Waveform Acquisition

NI Digital Multimeters Help (NI-DMM 18.1)

Edition Date: March 2018

Part Number: 370384V-01

»View Product Info
Download Help (Windows Only)

Configures the device for waveform acquisitions.

Note  This feature is supported on the NI 4080/4081/4082 and the NI 4070/4071/4072.

niDMM Configure Waveform Acquisition

/images/reference/en-XX/help/370384V-01/cio.gif

instrument handle identifies a particular instrument session.

You obtain the instrument handle parameter from niDMM Initialize or niDMM Initialize With Options.

/images/reference/en-XX/help/370384V-01/cenum.gif

Function specifies the measurement function used in a waveform acquisition.

NI-DMM sets the Function property to this value.

WAVEFORM VOLTAGE (default) 1003 Waveform Voltage
WAVEFORM CURRENT 1004 Waveform Current
/images/reference/en-XX/help/370384V-01/cdbl.gif

Rate specifies the rate of the acquisition in samples per second.

NI-DMM sets the Waveform Rate property to this value. The valid rate is calculated by dividing 1,800,000 by an integer divisor, and the rate falls between 10 and 1,800,000 samples per second. The waveform rate is coerced upwards to the next valid rate. The default value is 1,800,000 samples per second.

/images/reference/en-XX/help/370384V-01/ci32.gif

Waveform Points specifies the number of points to acquire before the waveform acquisition completes.

NI-DMM sets the Waveform Points property to this value. The default value is 500. Setting the waveform points to 0 on the NI 4080/4081/4082 causes the waveform points to be acquired continuously.

/images/reference/en-XX/help/370384V-01/cdbl.gif

Range specifies the expected maximum amplitude of the input signal and sets the range for the measurement function.

NI-DMM sets the Range property to this value. Range values are coerced up to the closest input range. The default value is 10.0.

Auto-ranging is not supported during waveform acquisitions.

For valid ranges, refer to the Devices section of the NI Digital Multimeters Help.

/images/reference/en-XX/help/370384V-01/cerrcodeclst.gif

error in describes error conditions that occur before this VI runs. If an error occurred before this VI runs, the VI passes the error in value to error out. This VI runs normally only if no error occurs before this VI runs. If an error occurs while this VI runs, it continues and sets its own error status in error out. Use niDMM Error Message to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

/images/reference/en-XX/help/370384V-01/cbool.gif

status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.

/images/reference/en-XX/help/370384V-01/ci32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/370384V-01/cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

/images/reference/en-XX/help/370384V-01/iio.gif

instrument handle out returns a handle that you use to identify the instrument in all subsequent instrument driver VI calls.

/images/reference/en-XX/help/370384V-01/ierrcodeclst.gif

error out contains error information. If error in indicates that an error occurred before this VI ran, error out contains the same error information. Otherwise, it describes the error status that this VI produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

/images/reference/en-XX/help/370384V-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370384V-01/ii32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/370384V-01/istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

WAS THIS ARTICLE HELPFUL?

Not Helpful