Dynamic Acquisition:Fetch:Fetch Relative To Property

NI Digital Waveform Generator/Analyzer Help

Edition Date: June 2013

Part Number: 370520P-01

»View Product Info
Download Help (Windows Only)

Short Name: FetchRelativeTo

Property of niHSDIO

Specifies the absolute location within the acquired record from which to begin fetching. The default value is Current read position. However, NI-HSDIO changes the default value internally as follows. If the Reference trigger is enabled (not disabled), then the fetch occurs from the first pretrigger sample. If the Reference trigger is disabled, then the fetch occurs from the first sample.

Related Topics

Most recent sample (46)

Specifies that fetching occurs relative to the most recently acquired data. The Fetch Offset property must be negative to use this value.

First sample (47)

Specifies that fetching occurs at the first sample acquired by the device. If the device wraps its buffer, then the first sample is no longer available. In this case, NI-HSDIO returns an error if the fetch offset is in the overwritten data.

Reference trigger (48)

Specifies that fetching occurs relative to the Reference trigger. This value behaves like First Sample if no Reference trigger is configured.

First pretrigger sample (49)

Specifies that fetching occurs relative to the first pretrigger sample acquired. This value behaves like First Sample if no Reference trigger is configured.

Current read position (50)

Specifies that fetching occurs after the last fetched sample. The initial read position depends on whether the Reference trigger is enabled. If the Reference trigger is disabled, the initial read position is the first sample acquired. If a Reference trigger is enabled, the initial read position is the first pretrigger sample.

Remarks

The following table lists the characteristics of this property.

Datatype iL
PermissionsRead/Write
High-level VIs N/A
Channel-based No
ResettableNo

WAS THIS ARTICLE HELPFUL?

Not Helpful