niRFSA_ConfigureNumberOfRecords
- Updated2025-10-14
- 2 minute(s) read
Configures the number of records in a finite acquisition or configures the device to continuously acquire records.
Syntax
ViStatus _VI_FUNC niRFSA_ConfigureNumberOfRecords(ViSession vi, ViConstString channelList, ViBoolean numberOfRecordsIsFinite, ViInt64 numberOfRecords)
Remarks
You can only configure the device to acquire multiple records if you set the numberOfRecordsIsFinite parameter to VI_TRUE.
If you configure the device to continuously acquire samples, it continues acquiring data until you call the niRFSA_Abort function to abort the acquisition. The device stores data in onboard memory in a circular fashion. After the device fills the memory, it starts overwriting previously acquired data from the beginning of the memory buffer. Retrieve the samples as they are being acquired, using one of the niRFSA fetch I/Q functions, to avoid overwriting data before you retrieve it.
To acquire more records than will fit into the device memory without continuously acquiring records, set the numberOfRecordsIsFinite parameter in this function to VI_TRUE and the NIRFSA_ATTR_ALLOW_MORE_RECORDS_THAN_MEMORY attribute to VI_TRUE.
Supported Devices: PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5820/5830/5831/5832/5840/5841/5842/5860
Related Topics
Parameters
| Name | Direction | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|
| vi | [in] | ViSession | Identifies your instrument session. vi is obtained from the niRFSA_Init or niRFSA_InitWithOptions function. | ||||||
| channelList | [in] | ViConstString | Identifies which channels to apply settings. Specify an empty string as the value of this parameter. | ||||||
| numberOfRecordsIsFinite | [in] | ViBoolean | Specifies whether to configure the device to acquire a finite number of records or to acquire records continuously. The default is VI_TRUE.
| ||||||
| numberOfRecords | [in] | ViInt64 | Specifies the number of records to acquire if numberOfRecordsIsFinite is set to VI_TRUE. |
Returns
Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an NI-RFSA function to determine if an error has occurred. To obtain a text description of the status code and additional information about the error condition, call the niRFSA_GetError function. To clear the error information from NI-RFSA, call the niRFSA_ClearError function. The general meaning of the status code is as follows:
Value | Meaning |
|---|---|
0 | Success |
Positive Values | Warnings |
Negative Values | Errors |