Admin Production ni-theme
Current Publication

Fetch

IVI Compliance Package

IviCounter Fetch

IviCounterBase Capability Group

Obtains a measurement based on the preset configuration and returns the measurement value. The measurement is from a measurement that was previously initiated.

Use the IviCounter Initiate VI to start the previously configured measurement. Use the IviCounter Status VI to determine when the measurement is complete.

You can call the IviCounter Read VI instead of the IviCounter Initiate VI. The IviCounter Read VI starts a measurement. It then waits for the measurement to complete, obtains the measured value, and returns the measured value. You call this VI separately for any other measurements that you want to obtain on a specific channel.


Note Note  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 IviCounter Error-Query VI at the conclusion of the sequence.

IviCounter Fetch.vi

civrn instrument handle The instrument handle you obtain from the IviCounter Initialize VI or IviCounter Initialize With Options VI. The handle identifies a particular instrument session.

Default Value: None
cerrcodeclst 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.
iivrn instrument handle out The instrument handle you obtain from the IviCounter Initialize VI or IviCounter Initialize With Options VI. The handle identifies a particular instrument session.

Default Value: None
idbl measurement Returns the measured value.

The units depend on the Measurement Function you select as shown below.

Rise Time seconds
Fall Time seconds
Frequency hertz
Frequency Ratiounits
PRF hertz
Period seconds
Phase degrees
Negative seconds
Width Positive seconds
Cycle Negative percent
Duty Cycle Positive percent
Time Interval seconds
Totalize occurrences
ierrcodeclst 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.