Returns the margin on non-allocated resource blocks (RBs) within the subblock aggregated bandwidth. This value is expressed in dB.
The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION attribute to Uplink and the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE attribute to LO per Subblock.
Refer to section 6.5.2A.3 of the 3GPP TS 36.521 specification for more information about in-band emission margin.
Use "subblock<n>" as the selector string to read results from this function.

Syntax

int32 __stdcall RFmxLTE_ModAccFetchSubblockInBandEmissionMargin(niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 *subblockInBandEmissionMargin)

Parameters

NameDirectionTypeDescription
instrumentHandle[in]niRFmxInstrHandle

This parameter specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr_Initialize function.

selectorString[in]char

This parameter specifies a Selector String comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "subblock0".
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString function to build the selector string.

timeout[in]float64

This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete. The default value is 10.

subblockInBandEmissionMargin[out]float64 *

This parameter returns the in-band emission margin of a subblock aggregated bandwidth. This value is expressed in dB.
The margin is the lowest difference between the in-band emission measurement trace and the limit trace. The limit is defined in section 6.5.2A.3 of the 3GPP TS 36.521 specification.
The in-band emissions are a measure of the interference in the non-allocated resources blocks. This result is valid only when you set the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE attribute to LO per Subblock.

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 RFmx 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 RFmxLTE_GetError function.

The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors