IviScope_ActualRecordLength
IviScopeBase Capability Group
C Function Prototype
ViStatus IviScope_ActualRecordLength (ViSession vi, ViInt32 *actualRecordLength);
Purpose
This function returns the actual number of points the oscilloscope acquires for each channel. After configuring the oscilloscope for an acquisition, call this function to determine the size of the waveforms that the oscilloscope acquires. The value is equal to or greater than the minimum number of points specified in the IviScope_ConfigureAcquisitionRecord function.
Allocate a ViReal64 array of this size or greater to pass as the waveformArray parameter of the IviScope_ReadWaveform and IviScope_FetchWaveform functions. The oscilloscope may use different size records depending on the acquisition type. Specify the acquisition type with the IviScope_ConfigureAcquisitionType function.
Parameters
| Inputs | Type | Description |
|---|---|---|
| vi | ViSession | The instrument handle that you obtain from the IviScope_init or IviScope_InitWithOptions functions. The handle identifies a particular IVI session. |
| Outputs | Type | Description |
| actualRecordLength | ViInt32 | Returns the actual number of points the oscilloscope acquires for each channel. The driver returns the value held in the IVISCOPE_ATTR_HORZ_RECORD_LENGTH attribute. |