User`s guide

4-238 Agilent E6432A Microwave Synthesizer User’s Guide
HPE6432_WriteListData
ViStatus HPE6432_WriteListData (ViSession instrumentHandle,
ViUInt32 startingPoint, ViUInt32 numberOfPoints, ViInt32
listPointData[]);
Purpose
This function writes an array of list point data to the synthesizer’s
internal list point memory.
A List is defined as one or more points that can be stored in the
synthesizer’s List Point Memory. The synthesizer’s list point memory
can hold 131,071 points (with a range of 0 to 131,070) and can be
broken up into different size lists; although there can be multiple lists
stored in list point memory, only one list can be run at a given time.
Each list is delimited by two parameters that specify its Starting Point
and its Number of Points (length).
For example, using C, you could read and write 10 points to list point
memory as follows:
int rtn=0;
ViInt32 buf[40];
/* Load buf with list data */
rtn= HPE6432_ReadListData(instrumentHandle, 0, 10, buf);
/* Create duplicate list at list point memory 100 */
rtn= HPE6432_WriteListData(instrumentHandle, 100, 10, buf);
fwrite(buf, 16, 10, stream);
Parameter List
instrumentHandle
Variable Type ViSession
This is the ViSession handle that is obtained from the Initialize
function. The instrumentHandle identifies a particular instrument
session.
startingPoint
Variable Type ViUInt32
This parameter specifies a starting point in the list point memory at
which to begin writing the list data.
Valid range: 0 to (131,070 - Number_of_Points)