RFmxEVDO_BuildSignalString

NI-RFmx EV-DO 2.5 Help

Edition Date: June 2018

Part Number: 375769F-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall RFmxEVDO_BuildSignalString (char signalName[], char resultName[], int32 selectorStringLength, char selectorString[]);

Purpose

Creates a selector string for use with configuration or fetch attributes and functions.
Refer to the Selector String topic for information about the string syntax for named signals.

Parameters

Input
Name Type Description
signalName char[] Specifies the name of the signal when using named signal configurations. This input accepts the signal name with or without the "signal::" prefix.
Examples:
""
"signal::sig1"
"sig1"
resultName char[] Specifies the name of the result when performing overlapped measurements. This input accepts the result name with or without the "result::" prefix.
Examples:
""
"result::r1"
"r1"
selectorStringLength int32 Specifies the length of the selector string. Set this parameter to 0 to get the minimum buffer size required to build the selector string.
selectorString char[] Returns the selector string you can use in the selectorString input parameter for Configuration functions, Fetch functions, or other functions that build selector strings. This string contains the signal and/or result names with their appropriate prefixes.
Examples:
""
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"

Return Value

Name Type Description
statusOrRequiredSize int32 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.

When the statusOrRequiredSize return value returns the buffer size, the status code is not returned.

To obtain a text description of the status code and additional information about the error condition, call the RFmxEVDO_GetError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful