Admin Production ni-theme
Current Publication

Initiate Acquisition

IVI Compliance Package

IviScope Initiate Acquisition

IviScope Base Capability Group

This VI initiates a waveform acquisition. After you call this VI, the oscilloscope leaves the Idle state and waits for a trigger. The oscilloscope acquires a waveform for each channel you have enabled with the IviScope Configure Channel VI.

Notes
  1. This VI does not check the instrument status. Typically, you call this VI only in a sequence of calls to other low-level driver VIs. The sequence performs one operation. You use the low-level VIs to optimize one or more aspects of interaction with the instrument. If you want to check the instrument status, call the IviScope Error-Query VI at the conclusion of the sequence.
  2. This VI performs interchangeability checking when the IviScope Interchange Check property is set to TRUE. Use NI I/O Trace to view interchangeability warnings. Alternately, you may use the IviScope Get Next Interchange Warning VI to retrieve interchangeability warnings. For more information about interchangeability checking, refer to the help text for the IviScope Interchange Check property.
  3. The class driver performs a simulated waveform acquisition when this VI is called and the IviScope Simulate property is set to TRUE and the IviScope Use Specific Simulation property is set to FALSE. For information on how to configure a simulated waveform, refer to IviScope Simulator Setup Dialog Box.

instrument handle The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.