Retrieves data from multiple channels and records. Returns a two-dimensional array of binary 16-bit waveforms.


icon

Inputs/Outputs

  • cdbl.png timeout —

    timeout is the time (in seconds) to wait for the data to be acquired. Use 0 for this parameter to tell NI-SCOPE to fetch whatever is currently available. Using -1 for this parameter implies infinite timeout.

  • civrn.png instrument handle —

    instrument handle identifies a particular instrument session.

  • cstr.png channels —

    channels specifies the channel(s) from which to acquire data. For more information, refer to Channel String Syntax.

  • ci32.png numSamples —

    numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

  • cerrcodeclst.png error in —

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

  • iivrn.png instrument handle out —

    instrument handle out has the same value as the instrument handle.

  • i1dnclst.png wfm info —

    wfm info contains all the timing and scaling information about the waveform.

  • ii32.png actualSamples —

    actualSamples is the actual number of samples in the acquired waveform; this number may be less than numSamples if the number you request is not available.

  • idbl.png absoluteInitialX —

    absoluteInitialX is the timestamp in seconds of the first fetched sample. This timestamp is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.

  • idbl.png relativeInitialX —

    relativeInitialX is the time in seconds from the trigger to the first sample in the acquired waveform.

  • idbl.png xIncrement —

    xIncrement indicates the time in seconds between two samples in the acquired waveform.

  • idbl.png offset —

    offset is the offset factor of the given channel.

    Use for scaling binary data with the following formula:

    voltage = binary data × gain factor + offset

  • idbl.png gain —

    gain is the gain factor of the given channel.

    Use for scaling binary data with the following formula:

    voltage = binary data × gain factor + offset

  • idbl.png reserved1 —

    reserved1 is reserved. Do not use.

  • idbl.png reserved2 —

    reserved2 is reserved. Do not use.

  • i2di16.png wfm —

    wfm returns a two-dimensional array of binary data; if you specify a channel list, NI-SCOPE returns the waveforms in the list order. NI-SCOPE returns these records sequentially, so all record 0 waveforms are first.

    For example, with a two-channel list, you would have the following index values:

    index 0 = record 0, channel 0

    index 1 = record 0, channel 1

    index 2 = record 1, channel 0

    index 3 = record 1, channel 1

  • ierrcodeclst.png error out —

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