IviScope_ActualRecordLength

CVI/LabWindows IVI Class Driver

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.

Return Values