niBTSA_GetCurrentIterationAcquiredIQTrace
- Updated2023-02-21
- 2 minute(s) read
int32 __stdcall niBTSA_GetCurrentIterationAcquiredIQTrace ( niBTSASession session, char channelString[], float64 *t0, float64 *dt, NIComplexNumber acquiredIQ[], int32 dataArraySize, int32 *actualNumDataArrayElements);
Purpose
Returns the unprocessed I/Q signal acquired from the NI RF vector signal analyzer.
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. |
| channelString | char[] | Set this parameter to "" (empty string) or NULL. |
| dataArraySize | int32 | Specifies the number of elements in the acquiredIQ array. |
| Output | ||
| Name | Type | Description |
| f0 | float64* | Returns the starting time, in seconds, of the unprocessed I/Q trace, where the start of packet corresponds to 0 seconds. |
| df | float64* | Returns the time interval, in seconds, between data points in the unprocessed I/Q trace. |
| acquiredIQ | NIComplexNumber[] | Returns the array of unprocessed I/Q signal acquired from the NI RF vector signal analyzer. |
| actualArraySize | int32* | Returns the actual number of elements populated in the acquiredIQ array. If the array is not large enough to hold all the samples, the function returns an error and the actualArraySize parameter returns the minimum expected size of the output array. |
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:
|
||||||||