Rohde & Schwarz 1065.6000.20, Operating Manual

Page: 409 / 438

Contents - Maintenance and Instrument Interfaces FSE
1065.6016.12 8.16 E-15
RSDLLibrd()
The function reads data from the instrument into the string
Rd
with the handle
ud
.
VB format:
Function RSDLLibrd (ByVal ud%, ByVal Rd$, ibsta%, iberr%,
ibcntl&) As Integer
C format:
short FAR PASCAL RSDLLibrd( short ud, char far *Rd, short far
*ibsta, short far *iberr, unsigned long far *ibcntl )
C format (Unix):
short RSDLLibrd( short ud, char *Rd, short *ibsta, short
*iberr, unsigned long *ibcntl )
Parameter:
ud
Device handle
Rd
String into which the read data are copied.
Example:
RSDLLibrd (ud, Rd, ibsta, iberr, ibcntl)
This function fetches replies of the IEC/IEEE-bus parser in response to a query command.
For this, a string of sufficient length must be generated when programming in Visual Basic. This can be
accomplished in the definition of the string or with the command
Space$()
.
Generation of a string of the length 100:
- Dim Rd as String * 100
- Dim Rd as String
Rd = Space$(100)
RSDLLilrd
The function reads
Cnt
bytes from the instrument with the handle
ud
.
VB format:
Function RSDLLilrd (ByVal ud%, ByVal Rd$, ByVal Cnt&, ibsta%,
iberr%, ibcntl&) As Integer
C format:
short FAR PASCAL RSDLLilrd( short ud, char far *Rd, unsigned
long Cnt, short far *ibsta, short far *iberr, unsigned long
far *ibcntl )
Parameter:
ud
Device handle
cnt
Maximum number of bytes copied to target string
Rd
by the
DLL.
Example:
RSDLLilrd (ud, RD, 100, ibsta, iberr, ibcntl)
The function reads data from an instrument same as function
RSDLLibrd()
but with the difference that
here the maximum number of bytes is allowed to be copied to target string
Rd
to be defined with
Cnt
.
Writing beyond a string can thus be prevented with this function. The number of bytes cut off is lost.
RSDLLibrdf()
Reads data from the instrument into the file
file
with the handle
ud
.
VB format:
Function RSDLLibrdf (ByVal ud%, ByVal file$, ibsta%, iberr%,
ibcntl&) As Integer
C format:
short FAR PASCAL RSDLLibrdf( short ud, char far *file, short
far *ibsta, short far *iberr, unsigned long far *ibcntl )
C format (Unix):
short RSDLLibrd( short ud, char *file, short *ibsta, short
*iberr, unsigned long *ibcntl )
Parameter:
ud
Device handle
file
File into which the read data are written.
Example:
RSDLLibrdf (ud, c:\db.sav, ibsta, iberr, ibcntl)
This function serves to read replies of the IEC/IEEE-bus parser that are larger than 64 KB. The file
name may include the drive and path.