niDMM_FetchWaveform
ViStatus = niDMM_FetchWaveform(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, returns an array of values from a previously initiated waveform acquisition. You must call niDMM_Initiate before calling this function.
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 [] | Waveform Array is an array of measurement values stored in waveform data type. |
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. |