niRFSA_ConfigureIQRate

NI RF Vector Signal Analyzers

niRFSA_ConfigureIQRate

ViStatus = niRFSA_ConfigureIQRate( ViSession vi, ViConstString channelList, ViReal64 iqRate);

Purpose

Configures the rate at which the device samples IQ values. Bandwidth is equal to the coerced iqRate times 0.8.

Note Note  You should not need to configure an IQ rate higher than 25 MHz, since the NI PXI-5600 downconverter bandwidth is 20 MHz. If you choose to configure a higher IQ rate, you may see aliasing effects at negative frequencies because the IF frequency of the downconverter is at 15 MHz.

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi is obtained from the niRFSA_init or the niRFSA_initWithOptions functions and identifies a particular instrument session.
channelList ViConstString Identifies channels to apply settings. Use "" or VI_NULL to specify all channels.
iqRate ViReal64 Specifies the IQ rate for the acquisition. The value is expressed in S/s.

Return Value

Name Type Description
status ViStatus Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. You examine the status code from each call to an instrument driver function to determine if an error occurred.

To obtain a text description of the status code, call the niRFSA_error_message function. To obtain additional information about the error condition, call the niRFSA_GetError function. To clear the error information from the driver, 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