niDMM_ReadWaveform
ViStatus = niDMM_ReadWaveform(ViSession Instrument_Handle, ViInt32 Maximum_Time, ViInt32 Array_Size, ViReal64 Waveform_Array[], ViInt32 *Actual_Number_Of_Points)
Purpose
For the NI 4070/4071/4072 only, acquires a waveform and returns data as an array of values or as a waveform data type. The number of elements in the Waveform_Array is determined by the values you specify for the Waveform_Points parameter in niDMM_ConfigureWaveformAcquisition.
Parameters
Input | ||||
Name | Type | Description | ||
Instrument_Handle | ViSession | Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None. | ||
Maximum_Time | ViInt32 | Specifies the Maximum_Time allowed for this function to complete in milliseconds. If the function does not complete within this time interval, the function 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 NIDMM_VAL_TIME_LIMIT_AUTO (-1). The DMM calculates the timeout automatically. |
||
Array_Size | ViInt32 | Specifies the number of waveform points to return. You specify the total number of points that the DMM acquires in the Waveform Points parameter of niDMM_ConfigureWaveformAcquisition. The default value is 1. | ||
Output | ||||
Name | Type | Description | ||
Waveform_Array | ViReal64[] | An array of measurement values.
|
||
Actual_Number_Of_Points | ViInt32* | Indicates the number of measured values actually retrieved from the DMM. |
Return Value
Name | Type | Description |
Status | ViStatus | Reports the Status of this operation. To obtain a text description of the status code, call niDMM_error_message. To obtain additional information concerning the error condition, use niDMM_GetError. |