IviDmm Read
IviDmm Base Capability Group
This VI initiates a measurement, waits until the DMM has returned to the Idle state, and returns the measured value.
This VI applies default values to properties that have not been set by you 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 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 IviDmm Abort to cancel the 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. |
 |
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 Returns the measured value. 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
|
||||||||||||||||||||||
 |
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. |