niDMM Fetch Multi Point

niDMM VIs

niDMM Fetch Multi Point

Returns an array of values from a previously initiated multipoint measurement.

The number of measurements the DMM makes is determined by the values you specify for the Trigger Count and Sample Count parameters of niDMM Configure Multi Point. You must call niDMM Initiate to initiate a measurement before calling this VI.

niDMM Fetch Multi Point

cio.gif

instrument handle identifies a particular instrument session.

You obtain the instrument handle parameter from niDMM Initialize or niDMM Initialize With Options. The default is None.

ci32.gif

Number to Fetch specifies the number of measurements to acquire.

The maximum number of measurements for a finite acquisition is the (Trigger Count x Sample Count) parameters in niDMM Configure Multi Point. For continuous acquisitions, up to 100,000 points can be returned at once. The number of measurements can be a subset. The valid range is any positive ViInt32. The default value is 1.

ci32.gif

Maximum Time (msec) specifies the maximum time allowed for this VI to complete in milliseconds. If the VI does not complete within this time interval, the VI returns the NIDMM_ERROR_MAX_TIME_EXCEEDED error code. This may happen if an external trigger has not been received, or if the specified timeout is not long enough for the acquisition to complete. The valid range is 0–86400000. The default value is TIME LIMIT AUTO (-1). The DMM calculates the timeout automatically.

ccclst.gif

error in (no error) 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.

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.

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.

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.

iio.gif

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

i1ddbl.gif

Measurements is an array of measurement values.

Note  The size of the Measurements Array must be at least the size that you specify for the Number to Fetch parameter.
ii32.gif

Actual Number indicates the number of measured values actually retrieved from the DMM.

icclst.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.

ibool.gif

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

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.

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.