User manual

Segment Descriptor for Raw Sequence Waveforms (readMode = 11) in
AqSegmentDescriptorSeqRaw
Name Type Description
horPos ViReal64 Horizontal position of first data point.
timeStampLo
timeStampHi
ViUInt32
ViUInt32
Low and high part of the 64-bit trigger timestamp. See
discussion below.
indexFirstPoint ViUInt32 Pointer to first sample of this segment
actualSegmentSize ViUInt32 Actual segment size, for the size of the circular buffer
reserved ViInt32 Reserved for future use
Data Descriptor in AqDataDescriptor
Name Type Description
returnedSamplesPerSeg ViInt32 Total number of data samples actually returned.
DataArray[indexFirstPoint]…
DataArray[indexFirstPoint+ returnedSamplesPerSeg-1]
indexFirstPoint ViInt32 Offset of the first valid data point, that of the first
sample, in the destination array. It should always be in
the range [0...31]. It is not an offset in bytes but rather
and index in units of samples that may occupy more
than one byte.
sampTime ViReal64 Sampling interval in seconds.
vGain ViReal64 Vertical gain in Volts/LSB. See discussion below.
vOffset ViReal64 Vertical offset in Volts. See discussion below.
returnedSegments ViInt32 Number of segments
nbrAvgWforms ViInt32 Number of averaged waveforms (nominal) in segment
actualTriggersInAcqLo
actualTriggersInAcqHi
ViUInt32
ViUInt32
Low and high part of the 64-bit count of the number of
triggers taken for the entire acquisition
actualDataSize ViUInt32 Actual length in bytes used at dataArray. This value is
only returned for SSR and Peak
TDC
Analyzers.
reserved2 ViInt32 Reserved for future use
reserved3 ViReal64 Reserved for future use
Discussion
All structures used in this function can be found in the header file AcqirisDataTypes.h. This file also
contains enum definitions for the allowed values of the members of the AqReadParameters structure.
The type of the dataArray is determined from the AqReadParameters struct entry dataType.
Remember to set all values of the AqReadParameters structure, including the reserved values.
The following dataType and readMode combinations are supported:
0 =
standard
1 =
image
2 =
averaged
3 =
gated
4 =
peaks
0 = Int8 8,10 8,10 - APX01 -
1 = Int16 10,12 10,12 - - -
2 = Int32 - - X - Peak
TDC
3 = Real64 X X X - APX01
5 =
short
avera
ged
6 = shifted
short
averaged
7 =
SSR
9 =
Histogram
10 =
peak
region
11 =
sequence
raw
0 = Int8 - - X 8,10
1 = Int16 X X - Peak
TDC
10,12
2 = Int32 - - - Peak
TDC
Peak
TDC
3 = Real64 X X -
Programmer’s Reference Manual Page 165 of 210