IviDmm Read MultiPoint
IviDmmMultiPoint Capability Group [MP]
This VI initiates the measurement, waits for the DMM to return to the Idle state, and returns an array of measured values. 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 MultiPoint [MP] VI.
This VI applies default values to properties that you have not set under the following conditions:
- If you have not set the value of any property in the IviDmmMultiPoint extension group, the VI sets the IviDmm Sample Count [MP] and IviDmm Trigger Count [MP] properties to 1.
- If you have not set the value of the IviDmm Auto Zero [AZ] property, the VI sets the value of this property to IVIDMM_VAL_AUTO_ZERO_OFF (0).
 |
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 read operation to complete. Express this value 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 the IviDmm Abort VI to cancel the multipoint read 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 Pass the number of elements in the Reading Array parameter.
Default Value: None |
||||||||||||||||||||||
 |
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. |