Returns an array of voltage measurements, an array of current measurements, and an array of compliance measurements that were previously taken and are stored in the niDCPower buffer.

This VI should not be used when the Measure When property is configured to On Demand. You must first call niDCPower Initiate With Channels before calling this VI.

Note This VI is not supported by all devices. Refer to Supported VIs by Device for information about supported devices.


icon

Inputs/Outputs

  • civrn.png instrument handle

    instrument handle identifies a particular instrument session.

  • cstr.png channel name

    channel name specifies the channel from which to fetch data. You can only fetch data from one channel at a time.

    Specify the channel using the form PXI1Slot3/0, where PXI1Slot3 is the instrument resource name and 0 is the channel.

  • ci32.png count (1)

    count (1) specifies the number of measurements to fetch.

  • cdbl.png timeout (1.0)

    timeout (1.0) specifies the maximum time allowed for this VI to complete, in seconds. If the VI does not complete within this time interval, NI-DCPower returns an error.

    Note When setting the timeout interval, ensure you take into account any triggers so that the timeout interval is long enough for your application.
  • cerrcodeclst.png error in (no error)

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • ii32.png actual count

    actual count indicates the number of measured values actually retrieved from the specified channel.

  • iivrn.png instrument handle out

    instrument handle out passes the handle used to identify the session in all subsequent NI-DCPower VI calls.

  • i1ddbl.png voltage measurements

    voltage measurements returns an array of voltage measurements.

  • i1ddbl.png current measurements

    current measurements returns an array of current measurements. The measurements in the array are returned in the same order as the channels specified in channel name.

  • i1dbool.png in compliance

    in compliance returns an array of Boolean values indicating whether the output was in compliance at the time the measurement was taken.

  • ierrcodeclst.png error out

    error out contains error information. This output provides standard error out functionality.

  • Details

    Behavior with LCR Measurements

    LCR-specific measurements may be present in the buffer when you call this VI in certain cases, such as when changing the instrument mode during an advanced sequence. If LCR measurements are in the buffer, this VI returns the DC portion of any available voltage and current measurements and discards LCR-specific measurements.