User manual

avgOvfl, avgStatus and avgMax will apply to Signal Averagers only. The features that they support have
not yet been implemented.
The value of segmentOffset must be ≥ nbrSamplesInSeg. The waveforms are thus transferred sequentially
into a single linear buffer, with 'holes' of length (segmentOffset – nbrSamplesInSeg) between them. Such
'holes' could be used for depositing additional segment-specific information before storing the entire
sequence as a single array to disk. If you specify firstSegment > 0, you don’t have to allocate any buffer
space for waveforms that are not read, i.e. waveformArray[0] corresponds to the first sample of the
segment firstSegment.
Example: In a DC270, if you specify nbrSamplesInSeg = segmentOffset = 1500. Then with nbrSegments =
80 and nbrSamplesNom = 1000, since the currentSegmentPad = 408, you would have to allocate at least
1408 * (80 + 1) = 114'048 bytes.
It is strongly recommended to allocate the waveform destination buffers permanently rather than
dynamically, in order to avoid system overheads for buffer allocation/deallocation.
LabWindowsCVI/Visual C++ Representation
ViStatus status = AcqrsD1_readData(ViSession instrumentID,
ViInt32 channel, AqReadParameters* readPar,
ViAddr dataArray, AqDataDescriptor* descriptor, ViAddr
segDesc);
LabVIEW Representations
Acqiris Dx.lvlib: (or Aq Dx) Read Multi-Segments.vi
This Vi is polymorphic, the sample data is returned in an array of type I8, I16 or DBL.
It is meant for the readout of multiple segments with readMode = 1.
Acqiris Dx.lvlib: (or Aq Dx) Read Single Segment.vi
This Vi is polymorphic, the sample data is returned in an array of type I8, I16.
It is meant for the readout of a single segment with readMode = 0.
Programmer’s Reference Manual Page 168 of 210