IviDmm Fetch MultiPoint
IviDmmMultiPoint Capability Group [MP]
This VI returns an array of values from a previously initiated multipoint measurement. The number of measurements the DMM takes is determined by the values you specify for the Trigger Count and Sample Count parameters of the IviDmm Configure Multi-Point [MP] VI.
Call the IviDmm Initiate VI to initiate a measurement before calling this VI.
 |
Notes
|
 |
instrument handle The instrument handle that you obtain from the IviDmm Initialize or IviDmm Initialize With Options VI. |
 |
maximum time (5000 ms) Pass the maximum length of
time in which to allow the multipoint fetch operation to complete expressed in milliseconds.
If the operation does not complete within this time interval, the VI returns the IVIDMM_ERROR_MAX_TIME_EXCEEDED (0xBFFA2003) error code. When this occurs, you can call IviDmm Abort to cancel the multipoint fetch operation and return the instrument to the Idle state. Defined Values: IVIDMM_VAL_MAX_TIME_INFINITE (–1)—Wait indefinitely for a timeout. IVIDMM_VAL_MAX_TIME_IMMEDIATE (0)—Do not wait for a timeout. Default Value: 5000 ms |
|
Note The Maximum Time parameter affects only this VI. It has no effect on other timeout parameters or properties. |
|
|
array size (1)
Pass the number of elements in the Reading Array parameter.
Default Value: 1 |
||||||||||||||||||||||
 |
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
||||||||||||||||||||||
 |
instrument handle out The instrument handle that you obtain from the IviDmm Initialize or IviDmm Initialize With Options VI. | ||||||||||||||||||||||
 |
reading array Returns an array of the most recent measurement values.
The value you specify for the Measurement Function parameter of the IviDmm Configure Measurement VI determines the units of this parameter, as shown in the following table.
|
||||||||||||||||||||||
|
Notes
|
 |
actual number of points Indicates the number of measured values the VI places in the Reading Array parameter. |
 |
error out
The error out cluster passes error or warning
information out of a VI to be used by other VIs.
The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |