Agilent Technologies E1439, User Manual

Page: 106 / 246

96
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_data_xfersize
Allows data to be read before an entire block had been acquired.
VXI plug&play Syntax
#include "age1439".h
ViStatus age1439_data_xfersize(ViSession id , ViInt32 xfersize );
ViStatus age1439_data_xfersize_get(ViSession id , ViPInt32 xfersizePtr );
Description
This command allows you to specify the allowable data transfer size in a situation where you
want to read a large block of data in increments before an entire block has been acquired.
Note
This function has no effect on the fiber output channel.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
xfersize specifies the data transfer size in samples.
AGE1439_XFERSIZE_MIN selects the minimum allowable transfer size.
AGE1439_XFERSIZE_MAX selects the maximum allowable transfer size. xfersize must be a
sub-multiple of blocksize or an error is generated.
AGE1439_XFERSIZE_DEF sets the default transfer size.
Note
xfersize is reset by any subsequent change in the blocksize parameter and therefore must be
specified after blocksize . See “age1439_data_setup” on page 90 .
xfersizePtr points to the data transfer size in number of bytes.
Return Value
AGE1439_SUCCESS indicates that a function was successful.
Values other than AGE1439_SUCCESS indicate an error condition or other important status
condition. To determine the error message, pass the return value to “age1439_error_message” on
page 102 .
See Also
“Commands which halt active measurements” on page 198 , “age1439_init” on page 132 ,
“age1439_data_setup” on page 90