User`s guide

4-140 Agilent E6432A Microwave Synthesizer User’s Guide
HPE6432_ReadListData
ViStatus HPE6432_ReadListData (ViSession instrumentHandle,
ViUInt32 startingPoint, ViUInt32 numberOfPoints, ViInt32
listPointData[]);
Purpose
This function reads an array of list points from list point memory and
provides it to an external application using the listPointData[] array.
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).
The Starting Point parameter specifies a starting point in the list point
memory at which to begin reading the list data.
The Number of Points (length) parameter specifies the number of points
to take from the list point memory.
The List Point Data parameter specifies the memory address to store
the list point data.
For example, using C, you could read 10 points from list point memory
as follows:
ViInt32 buf[40];
HPE6432_ReadListData(0, 10, buf);
fwrite(buf, 16, 10, stream);
NOTE Downloading large lists could take long periods of time that depend on
the speed of the computer and interface being used as well as the size of
the list. Examples are shown below of loading different size lists into
list point memory with the HPE6432_WriteListPoints function using
different interfaces and different speed computers. The times listed
below are given in seconds.