Dynamic Acquisition:Fetch:Fetch Relative To Property
- Updated2023-02-21
- 2 minute(s) read
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 |  |
| Permissions | Read/Write |
| High-level VIs | N/A |
| Channel-based | No |
| Resettable | No |