IviDmm_ReadMultiPoint
IviDmmMultipoint Capability Group
C Function Prototype
ViStatus IviDmm_ReadMultiPoint(ViSession vi, ViInt32 maxTime, ViInt32 arraySize, ViReal64 readingArray[], ViInt32 *actualPts);
Purpose
The number of measurements the DMM takes is determined by Trigger Count and Sample Count.
After this function executes, each element in the readingArray parameter is an actual reading or a value indicating that an overrange condition occurred. If an overrange condition occurs, the corresponding readingArray element contains an IEEE defined NaN (Not a Number) value and the function returns IVIDMM_WARN_OVER_RANGE.
Test each element in the readingArray parameter for overrange with the IviDmm_IsOverRange function.
Parameters
| Inputs | Type | Description | ||
| vi | ViSession | The instrument handle that you obtain from the IviDmm_init or IviDmm_InitWithOptions functions. The handle identifies a particular IVI session. | ||
| maxTime | ViInt32 | Pass the maximum length of time in milliseconds to allow the multipoint read operation to complete. If the operation does not complete within this time interval, the function returns the IVIDMM_ERROR_MAX_TIME_EXCEEDED error. When this occurs, you can call IviDmm_Abort to cancel the multipoint read operation and return the instrument to the Idle state.
Defined Values: IVIDMM_VAL_MAX_TIME_INFINITE—Wait indefinitely for a timeout. IVIDMM_VAL_MAX_TIME_IMMEDIATE—Do not wait for a timeout.
|
||
| arraySize | ViInt32 | Pass the number of elements in the readingArray parameter. | ||
| Outputs | Type | Description | ||
| reading Array |
ViReal64[] | Returns an array of the most recent measurement values. The value you specify for the measurementFunction parameter of the IviDmm_ConfigureMeasurement function determines the units of this parameter. Possible Units | ||
| actual Numberof Points |
ViInt32 | Indicates the number of measured values the function places in the readingArray parameter. |
