Commits settings to hardware, waits for hardware settling, and starts an acquisition.

Syntax

ViStatus _VI_FUNC niRFSA_Initiate(ViSession vi)

Remarks

You can use this function in conjunction with one of the niRFSA fetch I/Q functions to retrieve acquired I/Q data, or you can use the niRFSA_ReadIqSingleRecordComplexF64 function to both initiate the acquisition and retrieve I/Q data at one time.

Note

If you are using external digitizer mode, this function commits settings and waits for settling, but it does not start an acquisition. Notice that using the niRFSA_Commit function on its own commits settings to hardware, but the device does not wait for hardware settling.

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694/5698, PXIe-5820/5830/5831/5832/5840/5841/5842/5860

Related Topics

None (Trigger Type)

RF List Mode

NI RF Vector Signal Analyzer State Diagram

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies your instrument session. vi is obtained from the niRFSA_Init or niRFSA_InitWithOptions function.

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