NI RFmx Bluetooth Set And Get Attribute Functions

Set And Get Attribute Functions

Set Attributes
Get Attributes

Set Attributes

RFmxBT_SetAttributeString

int32 __stdcall RFmxBT_SetAttributeString (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, char attrVal[]);

Purpose

Sets the value of an RFmx string attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	char[]	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI8

int32 __stdcall RFmxBT_SetAttributeI8 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int8 attrVal);

Purpose

Sets the value of an RFmx 8-bit integer (int8) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int8	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU8

int32 __stdcall RFmxBT_SetAttributeU8 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt8 attrVal);

Purpose

Sets the value of an RFmx 8-bit unsigned integer (uInt8) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt8	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI16

int32 __stdcall RFmxBT_SetAttributeI16 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int16 attrVal);

Purpose

Sets the value of an RFmx 16-bit integer (int16) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int16	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU16

int32 __stdcall RFmxBT_SetAttributeU16 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt16 attrVal);

Purpose

Sets the value of an RFmx 16-bit unsigned integer (uInt16) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt16	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI32

int32 __stdcall RFmxBT_SetAttributeI32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int32 attrVal);

Purpose

Sets the value of an RFmx 32-bit integer (int32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int32	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU32

int32 __stdcall RFmxBT_SetAttributeU32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt32 attrVal);

Purpose

Sets the value of an RFmx 32-bit unsigned integer (uInt32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt32	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI64

int32 __stdcall RFmxBT_SetAttributeI64 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int64 attrVal);

Purpose

Sets the value of an RFmx 64-bit integer (int64) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int64	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeF64

int32 __stdcall RFmxBT_SetAttributeF64 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float64 attrVal);

Purpose

Sets the value of an RFmx 64-bit floating point number (float64) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	float64	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeF32

int32 __stdcall RFmxBT_SetAttributeF32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float32 attrVal);

Purpose

Sets the value of an RFmx 32-bit floating point number (float32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	float32	Pass the value to which you want to set the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI8Array

int32 __stdcall RFmxBT_SetAttributeI8Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int8 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 8-bit integer (int8) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int8[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI32Array

int32 __stdcall RFmxBT_SetAttributeI32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int32 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 32-bit integer (int32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int32[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeI64Array

int32 __stdcall RFmxBT_SetAttributeI64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int64 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 64-bit integer (int64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	int64[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU8Array

int32 __stdcall RFmxBT_SetAttributeU8Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt8 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 8-bit unsigned integer (uInt8) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt8[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU32Array

int32 __stdcall RFmxBT_SetAttributeU32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt32 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 32-bit unsigned integer (uInt32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt32[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeU64Array

int32 __stdcall RFmxBT_SetAttributeU64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt64 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 64-bit unsigned integer (uInt64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	uInt64[]	Pass the value to which you want to set the attribute. Note Some of the values might not be valid depending on the current state of the instrument session.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeF32Array

int32 __stdcall RFmxBT_SetAttributeF32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float32 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 32-bit floating point number (float32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	float32[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeF64Array

int32 __stdcall RFmxBT_SetAttributeF64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float64 attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx 64-bit floating point number (float64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	float64[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeNIComplexSingleArray

int32 __stdcall RFmxBT_SetAttributeNIComplexSingleArray (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, NIComplexSingle attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx NIComplexSingle attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	NIComplexSingle[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_SetAttributeNIComplexDoubleArray

int32 __stdcall RFmxBT_SetAttributeNIComplexDoubleArray (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, NIComplexDouble attrVal[], int32 arraySize);

Purpose

Sets the value of an RFmx NIComplexDouble attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
attrVal	NIComplexDouble[]	Pass the value to which you want to set the attribute.
arraySize	int32	Specifies the size of the 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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

Get Attributes

RFmxBT_GetAttributeString

int32 __stdcall RFmxBT_GetAttributeString (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int32 arraySize, char attrVal[]);

Purpose

Queries the value of an RFmx string attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Pass the number of bytes in the char buffer you specify for the attrVal parameter. If you pass 0, you can pass NULL for the attrVal parameter.
Output
Name	Type	Description
attrVal	char[]	Returns the current value of the attribute. This parameter must have at least as many bytes as indicated in the arraySize parameter. If you specify 0 for the arraySize parameter, you can pass NULL for this parameter.

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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI8

int32 __stdcall RFmxBT_GetAttributeI8 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int8 *attrVal);

Purpose

Queries the value of an RFmx 8-bit integer (int8) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	int8*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU8

int32 __stdcall RFmxBT_GetAttributeU8 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt8 *attrVal);

Purpose

Queries the value of an RFmx 8-bit unsigned integer (uInt8) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	uInt8*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI16

int32 __stdcall RFmxBT_GetAttributeI16 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int16 *attrVal);

Purpose

Queries the value of an RFmx 16-bit integer (int16) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	int16*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU16

int32 __stdcall RFmxBT_GetAttributeU16 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt16 *attrVal);

Purpose

Queries the value of an RFmx 16-bit unsigned integer (uInt16) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	uInt16*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI32

int32 __stdcall RFmxBT_GetAttributeI32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int32 *attrVal);

Purpose

Queries the value of an RFmx 32-bit integer (int32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	int32*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU32

int32 __stdcall RFmxBT_GetAttributeU32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt32 *attrVal);

Purpose

Queries the value of an RFmx 32-bit unsigned integer (uInt32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	uInt32*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI64

int32 __stdcall RFmxBT_GetAttributeI64 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int64 *attrVal);

Purpose

Queries the value of an RFmx 64-bit integer (int64) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	int64*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeF64

int32 __stdcall RFmxBT_GetAttributeF64 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float64 *attrVal);

Purpose

Queries the value of an RFmx 64-bit floating point number (float64) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being read. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	float64*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeF32

int32 __stdcall RFmxBT_GetAttributeF32 (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float32 *attrVal);

Purpose

Queries the value of an RFmx 32-bit floating point number (float32) attribute.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
Output
Name	Type	Description
attrVal	float32*	Returns the current value of the attribute.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI8Array

int32 __stdcall RFmxBT_GetAttributeI8Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int8 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 8-bit integer (int8) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	int8[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array. If you set the arraySize parameter to 0, it returns the required array size.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI32Array

int32 __stdcall RFmxBT_GetAttributeI32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int32 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 32-bit integer (int32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	int32[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeI64Array

int32 __stdcall RFmxBT_GetAttributeI64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, int64 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 64-bit integer (int64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	int64[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU8Array

int32 __stdcall RFmxBT_GetAttributeU8Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt8 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 8-bit unsigned integer (uInt8) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	uInt8[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU32Array

int32 __stdcall RFmxBT_GetAttributeU32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt32 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 32-bit unsigned integer (uInt32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	uInt32[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeU64Array

int32 __stdcall RFmxBT_GetAttributeU64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, uInt64 attrVal[], int32 arraySize, int32* actualArraySize);

Purpose

Queries the value of an RFmx 64-bit unsigned integer (uInt64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	uInt64[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeF32Array

int32 __stdcall RFmxBT_GetAttributeF32Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float32 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 32-bit floating point number (float32) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	float32[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeF64Array

int32 __stdcall RFmxBT_GetAttributeF64Array (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, float64 attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx 64-bit floating point number (float64) attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	float64[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeNIComplexSingleArray

int32 __stdcall RFmxBT_GetAttributeNIComplexSingleArray (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, NIComplexSingle attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx NIComplexSingle attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	NIComplexSingle[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxBT_GetAttributeNIComplexDoubleArray

int32 __stdcall RFmxBT_GetAttributeNIComplexDoubleArray (niRFmxInstrHandle instrumentHandle, char selectorString[], int32 attributeID, NIComplexDouble attrVal[], int32 arraySize, int32 *actualArraySize);

Purpose

Queries the value of an RFmx NIComplexDouble attribute. You must provide a char array to serve as a buffer for the value. Pass the number of bytes in the buffer as the arraySize parameter. If you want to call this function just to get the required buffer size, you must pass 0 for arraySize and NULL for the attrVal buffer.

If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the arraySize parameter, the function copies buffer size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the buffer size you must pass to get the entire value. For example, if the value is "123456" and the buffer size is 4, the function places "123" into the buffer and returns 7.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
selectorString	char[]	Specifies the selector string for the attribute being set. Refer to the Selector String (C/CVI) topic for more information about configuring the selector string.
attributeID	int32	Pass the ID of an attribute.
arraySize	int32	Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name	Type	Description
attrVal	NIComplexDouble[]	Returns the current value of the attribute.
actualArraySize	int32*	Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

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 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 RFmxBT_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

NI-DAQmx

gRPC API Differences From C API

Task Configuration And Control

Channel Configuration And Creation

Timing

Triggering

Read Functions

Write Functions

Export Hardware Signals

Scale Configuration

Internal Buffer Configuration

Advanced Functions

System Configuration

Error Handling

Buffer Attributes

Calibration Info Attributes

Channel Attributes

Device Attributes

Export Signal Attributes

Persisted Channel Attributes

Persisted Scale Attributes

Persisted Task Attributes

Physical Channel Attributes

Read Attributes

Scale Attributes

System Attributes

Task Attributes

Timing Attributes

Trigger Attributes

Watchdog Attributes

Write Attributes

NI-DCPOWER

Setup Functions

Configure Functions

Measurement Functions

Control Functions

Trigger And Event
Attribute Functions

Query Functions

Calibration Functions

Utility Functions

Supported Device
Source Attributes

Transient Attributes

Voltage Attributes

Current Attributes

Pulse Voltage Attributes

Pulse Current Attributes

Cutoff Attributes

Measurement Attributes

Trigger Attributes Functions

Event Attributes

Advanced Attributes

Inherent Ivi Attributes

Supported Device Attributes

NI-DIGITAL PATTERN DRIVER

Init And Close Functions

Session Locking Functions

Utility Functions

Error Handling Functions

Calibration Functions

Attributes Functions

Pin Map Functions

Low Level Functions

Low Level Action Functions

Pin Control Functions

Static IO Functions

Clock Generator Functions

Levels And Timing Functions

TDR Functions

PPMU Configuration Functions

DC Voltage Functions

DC Current Functions

PPMU Action Functions

Pattern Configuration Functions

Pattern Action Functions

History Ram Functions

Source Memory Functions

Capture Memory Functions

Triggers And Events Functions

Conditional Jump Trigger Functions

Sequencer Flag Functions

Sequencer Register Functions

Match Fail Combination Functions

Pattern Results Functions

Sort Results Functions

Frequency Measurement Functions

IVI Inherent Attributes

Specific Driver Information Attributes, Read Only

Driver Setup Information Attributes

Device Attributes

Pin Control Attributes

Level Configuration Attributes

Trigger Configuration Attributes

PPMU Attributes

Patterns Attributes

Pattern Opcode Event Attributes

Timing Offset Attributes

Keep Alive Attributes

Frequency Measurement Attributes

Clock Generator Attributes

History RAM

Synchronization Attributes

TDR Endpoint Termination Attributes

NI-DMM

Setup Functions

Configuration Functions

Measurement Functions

Trigger Functions

Values And Attribute Functions

Acquisition Functions

Calibration Functions

Utility Functions

Configuration Attributes

Inherent IVI Attributes

Multi Point Acquisition Attributes

NI-FGEN

Setup Functions

Configuration Functions

Standard Output Functions

Arbitrary Waveform Output Functions

Arbitrary Sequence Output Functions

Incremental Waveform Write Functions

Configure Clock Functions

Trigger And Syncronizations Functions

5404 Routing Functions

Script Output Functions

Configure Onboard Signal Processing Functions

Configure Peer To Peer Functions

Attribute Functions

Waveform Control Functions

Error Functions

Output Attributes

Arbitrary Waveform Attributes

Data Transfer Attributes

Onboard Signal Processing Attributes

Peer To Peer Attributes

Standard Function Attributes

Clock Attributes

Event Attributes

Triggering Attributes

Instrument Specific Attributes

Inherent IVI Attributes

5401 5411 5431

NI-FPGA

gRPC API Differences From C API

NI FPGA C Functions

NI-RFmx Bluetooth

gRPC API Differences From C API

General Functions

Configuration Functions

Set And Get Attribute Functions

Fetch Results Functions

Utility Functions

Build String Functions

Advanced Functions

General Attributes

Trigger Attributes

Packet Attributes

Auto Detect Signal Attributes

Modacc Attributes

ACP Attributes

Twenty dB Attributes

Frequency Range Attributes

TXP Attributes

Advanced Attributes

NI-RFmx NR

gRPC API Differences From C API

General Functions

Configuration Functions

Set And Get Attributes Functions

Fetch Results Functions

Utility Functions

Build String Functions

Advanced Functions

General Attributes

Trigger Attributes

Signal Detection Attributes

Component Carrier Attributes

List Attributes

Modacc Attributes

ACP Attributes

CHP Attributes

OBW Attributes

SEM Attributes

TXP Attributes

Pvt Attributes

Advanced Attributes

NI-RFmx WCDMA

gRPC API Differences From C API

NI RFmx WCDMA C Functions

NI-RFmx GSM

gRPC API Differences From C API

NI RFmx GSM C Functions

NI-RFmx CDMA2k

gRPC API Differences From C API

NI RFmx CDMA2k C Functions

NI-RFmx Instr

General Functions

Configuration Functions

Set And Get Attributes Functions

Utility

Build String

Calibration

Attributes

Advanced Attributes

NI-RFmx LTE

gRPC API Differences From C API

General Functions

Configuration Functions

Ch Configuration Functions

NB IoT Configuration Functions

ModAcc Configuration Functions

ACP Configuration Functions

CHP Configuration Functions

OBW Configuration Functions

SEM Configuration Functions

PVT Configuration Functions

SlotPhase Configuration Functions

SlotPower Configuration Functions

Set And Get Attribute Functions

ModAcc Fetch Functions

ACP Fetch Functions

CHP Fetch Functions

OBW Fetch Functions

SEM Fetch Functions

PVT Fetch Functions

SlotPhase Fetch Functions

SlotPower Fetch Functions

Utility Functions

Build String Functions

Advanced Functions

General Attributes

Trigger Attributes

Component Carrier Attributes

ModAcc Attributes

ACP Attributes

CHP Attributes

OBW Attributes

SEM Attributes

PVT Attributes

SlotPhase Attributes

SlotPower Attributes

Advanced Attributes

NI-RFmx SpecAn

gRPC API Differences From C API

General Functions

Configuration Functions

Set And Get Attribute Functions

Read Functions

Fetch Functions

Utility Functions

Marker Functions

Build String Functions

Advanced Functions

General Attributes

Trigger Attributes

ACP Attributes

Cdf Attributes

CHP Attributes

Fcnt Attributes

Harm Attributes

OBW Attributes

SEM Attributes

Spectrum Attributes

Spur Attributes

TXP Attributes

AMPM Attributes

Dpd Attributes

IQ Attributes

IM Attributes

NF Attributes

Phasenoise Attributes

PAVT Attributes

Advanced Attributes

NI-RFmx TD-SCDMA

gRPC API Differences From C API

NI RFmx TD-SCDMA C Functions

NI-RFmx WLAN

gRPC API Differences From C API

General Functions

Configuration Functions

Set And Get Attribute Functions

Fetch DSSS ModAcc Functions

Fetch OFDM ModAcc Functions

Fetch SEM Functions

Fetch TXP Functions

Fetch PowerRamp Functions

Utility Functions

Build String Functions

Advanced Functions

General Attributes

Trigger Attributes

OFDM Attributes

Auto Detect Signal Attributes

DSSS ModAcc Attributes

OFDM ModAcc Attributes

SEM Attributes

TXP Attributes

PowerRamp Attributes

Advanced Attributes

NI-RFSA

General Functions

Configuration Functions

Acquisition Functions

Utility Functions

Calibration Functions

General Attributes

Vertical Attributes

Signal Path Attributes

Acquisition Attributes

Acquisition Attributes

Triggers Attributes

Events Attributes

Device Characteristics Attributes

Peer To Peer Streaming Attributes

Configuration List Attributes

Inherent IVI Properties Attributes

De-embedding Attributes

Self Calibration Attributes

Factory Calibration Attributes

External Alignment Attributes

Device Specific Attributes

NI-RFSG

General Functions

Generation Configuration

Utility Functions

Calibration Functions

Arb Attributes

Clock Attributes

Configuration List Attributes

De-embedding Attributes

Device Characteristics Attributes

Device Specific Attributes

Events Attributes

External Calibration Attributes

Inherent IVI Attributes Attributes

IQ Impairment Attributes

Load Configurations Attributes

Modulation Attributes

Obsolete Attributes

Peer To Peer Attributes

RF Attributes

Self Calibration Attributes

Triggers Attributes

NI-SCOPE

Setup Functions

Configure Functions

Attribute Functions

Acquisition Functions

Measurement Functions

Calibrate Functions

Utility Funcitons

Error Handling Functions

IVI Compliance Or Obsolete Functions

Vertical Attributes

Horizontal Attributes

Trigger Attributes

Clocking Attributes

Synchronization Attributes

Acquisition Attributes

Waveform Measurements Attributes

Onboard Signal Processing Attributes

Peer To Peer Streaming Attributes

Device Attributes

IVI Or Obsolete Attributes

Instrument Capabilities Attributes

If Digitizer Attributes

NI-SWITCH

Setup Functions

Attribute Functions

Route Functions

Scan Functions

Relay Functions

Utility Functions

Value Constants

Channel Configuration Attributes

IVI Attributes

Matrix Configuration Attributes

Module Characteristics Attributes

Scanning Configuration Attributes

NI-TCLK

High-level Functions

Advanced Functions

Attribute Functions

NI-XNET

gRPC API differences from C APIs

General Functions

Cluster Properties

Database Properties

Device Properties

ECU Properties

Frame Properties

Interface Properties

LIN Schedule Entry Properties

LIN Schedule Properties

PDU Properties

Session Ethernet Properties

Session Frame Properties

Session Interface Properties

Session Properties

Session SAE J1939 Properties

Signal Properties

Subframe Properties

System Properties

IP-Stack Functions

Socket Options

Socket Functions