RFmxTDSCDMA_SetAttributeU64Array

RFmxTDSCDMA_SetAttributeU64Array

int32 __stdcall RFmxTDSCDMA_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 RFmxTDSCDMA_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and result name. 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. examples: "" "signal::sig1" "result::r1" "signal::sig1/result::r1" You can use the RFmxTDSCDMA_BuildSignalString function to build 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