Racal Instruments 3155, User Manual

Page: 121 / 202

User Manual 3155
Programming Reference 4-11
SendBlock
Purpose
Use this function to send arbitrary waveform values as well as FM arbitrary waveform values
to the instrument either from an external file or from an array.
C Syntax
INSTRUMENTSTATE SendBlock (int hInstr, WORD mode, char *pFileName, void *pWave,
DWORD size)
Resource Classes
PXI, PCI
Parameters
Name
Description
hInstr
Instrument handle number. Must be out of a range of instruments that were found in the PXI baskets.
The numbers start at 0 (for first device) to n-1. This value is extracted using the RIComm.dll function
FindInstrument()
mode
Set this parameter to 1 if you are downloading arbitrary data. Set to 2 if you’re downloading arbitrary
FM data.
pFileName
Use this parameter to load waveform data from an external file. “NULL” indicates that the data comes
from an internal array. “<file_name>” defines the name and path of the external file. You can use
complete path if file location is outside the working folder.
pWave
Pointer to an array in memory where the data values of the arbitrary waveform can be found. If using
external files, then use NULL for this parameter.
size
If you are using an external file, then set this parameter to 0. If you are using an array, this parameter
specifies the number of bytes at the pointer location used as data values for the arbitrary waveform.
For arbitrary waveforms, each data point requires 2 bytes and for arbitrary FM waveforms, each data
point requires 5 bytes.
Return Values
Completion Codes
Description
PCI_SUCCESS
Function executed without errors
PCI_INS_ALREADY_OPEN
Trying to establish new communication link while instrument has already been connected.