Admin Production ni-theme
Current Publication

Acquisition Status

IVI Compliance Package

IviScope Acquisition Status

IviScope Base Capability Group

This VI returns whether an acquisition is in progress, complete, or if the status is unknown.

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. If the instrument cannot return its acquisition status, this VI returns the IVISCOPE_VAL_ACQ_STATUS_UNKNOWN value in the Acquisition Status parameter.


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.
acquisition status Returns the acquisition status of the oscilloscope. Possible values that this parameter returns are:

  • IVISCOPE_VAL_ACQ_IN_PROGRESS (0)—The oscilloscope is currently acquiring a waveform.
  • IVISCOPE_VAL_ACQ_COMPLETE (1)—The acquisition is complete.
  • IVISCOPE_VAL_ACQ_STATE_UNKNOWN (-1)—The driver cannot determine the status of the acquisition.
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.