Racal Instruments 3156B, Руководство пользователя

Страница: 229 / 385

3156B User Manual
Racal Instrument © 2005 Programming Reference 5-77
Ri3156b_load_arb_data
Description
Selects the arbitrary data segment and loads data into the segment. This function supports both 12-bit (normal)
and 16-bit (user) downloads. The format of the data is selected using the ri3156B_set_wave_format () function.
The byte order of the data is selected using the ri3156B_set_byte_order() function.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_load_arb_data (ViSession instrHandle, ViInt16 segmentNumber, ViInt16 _VI_FAR
dataPointArray[],ViInt32 number_ofPoints)
Parameters
Name
Variable
Type
Description
instrHandle ViSession The Instrument Handle is used to identify the unique
session or communication channel between the driver
and the instrument. If more than one instrument of the
model type is used, this will be used to differentiate
between them. Note that the initialize function may be
used to associate multiple instrument handles with a
single instrument.
segmentNumber
ViInt16
Select the segment number to become active
Valid range: 1 to 16k
Default: 1
dataPointArray
ViInt16[]
Select an array of data to be downloaded to a specific
memory segment.
Data range: 0 to 0xFFF (12-bit) or 0 to 0xFFFF (16-bit)
number_ofPoints
ViInt32
Select the size of the segment to be loaded. Size must
match the number of data points in the data array.
Valid range: 1 to 523264 with SCLK setting of 100MS/s;
2 to 1046528 with SCLK setting of 200MS/s
Return Values
Displays the return status of the function call. If the function was successful, it will return a status of
VI_SUCCESS, otherwise it will return an error code. Passing the error code into the function
"ri3156B_error_message()" will return a string describing the error.