niBTSA_RFSAMeasure
- Updated2023-02-21
- 2 minute(s) read
int32 __stdcall niBTSA_RFSAMeasure (niBTSASession session, ViSession RFSAHandle, char hwChannelString[], double timeout);
Purpose
Configures the NI RF vector signal analyzer and initiates acquisition on the hardware. This function then fetches the waveforms and calls the niBTSA_AnalyzePowerSpectrum function in a loop n times to perform measurements on the acquired waveforms, where n is equal to the number of averages specified.
Parameters
| Input | ||
| Name | Type | Description |
| session | niBTSASession | Specifies the niBT SA session. Use this parameter to configure the behavior and operation of the appropriate NI Bluetooth Analysis Toolkit function that accepts the niBTSASession as an input. |
| RFSAHandle | ViSession | Identifies the instrument session. The toolkit obtains this parameter from the niRFSG_init function or the niRFSG_InitWithOptions function. |
| hwChannelString | char[] | Specifies the NI RF vector signal analyzer device channel. Set this parameter to "" (empty string) or NULL. |
| timeout | double | Specifies the time, in seconds, allotted for the function to complete before returning a timeout error. A value of -1 specifies that the function waits until all data is available. A value of 0 specifies that the niBTSA_RFSAMeasure function returns the available data immediately. The default value is 10. |
Return Value
| Name | Type | Description | ||||||||
| status | int32 | Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an niBT SA 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 niBTSA_GetErrorString function. The general meaning of the status code is as follows:
|
||||||||