IviScope_ReadWaveformMeasurement
IviScopeWaveformMeasurement Capability Group
C Function Prototype
ViStatus IviScope_ReadWaveformMeasurement (ViSession vi, ViConstString channel ViInt32 measFunction, ViInt32 maxTime, ViReal64 *measurement);
Purpose
This function initiates a new waveform acquisition and returns a specified waveform measurement from a specific channel.
This function initiates an acquisition on the channels that you enable with the IviScope_ConfigureChannel function. It then waits for the acquisition to complete, obtains a waveform measurement on the channel you specify, and returns the measurement value. You specify a particular measurement type, such as rise time, frequency, and voltage peak-to-peak.
You can call the IviScope_FetchWaveformMeasurement function separately to obtain any other waveform measurement on a specific channel without initiating another acquisition.
You must configure the appropriate reference levels before calling this function to take a rise time, fall time, width negative, width positive, duty cycle negative, or duty cycle positive measurement.
Configure the low, mid, and high references either by calling the IviScope_ConfigureRefLevels function or by setting the following attributes:
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. |
| channel | ViConstString | Name of the channel from which to read a waveform. |
| measFunction | ViInt32 | Characteristic of the acquired waveform to be measured. |
| maxTime | ViInt32 | Specifies the maximum time allowed for this function to complete in milliseconds. Defined values: IVISCOPE_VAL_MAX_TIME_IMMEDIATE |
| Outputs | Type | Description |
| measurement | ViReal64 | The measured value. |