RelativeTo Property

NI-DAQmx Properties

RelativeTo Property

Short Name: RelativeTo

Property of DAQmx Read

Specifies the point in the buffer at which to begin a read operation. If you also specify an offset with Offset, the read operation begins at that offset relative to the point you select with this property. The default value is Current Read Position unless you configure a Reference Trigger for the task. If you configure a Reference Trigger, the default value is First Pretrigger Sample.

First Sample (10424) Start reading samples relative to the first sample acquired.
Current Read Position (10425) Start reading samples relative to the last sample returned by the previous read. For the first read operation, this position is the first sample acquired or the first pretrigger sample if you configured a reference trigger for the task.
Reference Trigger (10426) Start reading samples relative to the first sample after the reference trigger occurred.
First Pretrigger Sample (10427) Start reading samples relative to the first pretrigger sample. You specify the number of pretrigger samples to acquire when you configure a reference trigger.
Most Recent Sample (10428) Start reading samples relative to the next sample acquired. For example, use this value and set Offset to -1 to read the last sample acquired.

Remarks

The following table lists the characteristics of this property.

Permissionsread/write
Resettableyes
Settable while task is runningdevice-specific
Available in Run-Time Engineyes