IviScope_InitiateAcquisition

CVI/LabWindows IVI Class Driver

IviScope_InitiateAcquisition

IviScopeBase Capability Group

C Function Prototype

ViStatus IviScope_InitiateAcquisition (ViSession vi);

Purpose

This function initiates a waveform acquisition.

After calling this function, the oscilloscope leaves the Idle state and waits for a trigger. The oscilloscope acquires a waveform for each channel you enable with the IviScope_ConfigureChannel function.

This function does not check the instrument status. Typically, you call this function only in a sequence of calls to other low-level driver functions. The sequence performs one operation. Use the low-level functions to optimize one or more aspects of interaction with the instrument. Call the IviScope_error_query function at the conclusion of the sequence to check the instrument status.

Parameters

Name 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.

Return Values