Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual
Page 339

15B. Driver488/SUB, W31, W95, & WNT
III. COMMAND REFERENCES - 15. Command References
III-324
Personal488 User’s Manual, Rev. 3.0
Driver488 provides additional
EnterI
routines that are short form versions of the
EnterXI
function.
The additional
EnterI
functions are:
EnterI
,
EnterNI
,
EnterMoreI
, and
EnterNMoreI
. These
functions are discussed in detail below:
EnterNI
SYNTAX
EnterNI(ByVal devHandle%,data%,By Val count& ) As Long
REMARKS
EnterNI
is equivalent to the following call to
EnterXI
:
EnterXI(devHandle%,data%,count&, 1, 0, 0, 0)
The
EnterNI
function passes the device handle, the pointer to the data buffer, and the size of the data
buffer to the
EnterXI
function. It specifies
forceAddr%
is
TRUE
, causing Driver488 to re-address the
device. The default terminators are chosen by specifying a
0
pointer as the
term
parameter.
Asynchronous transfer is turned off by sending
0
for the
async%
parameter, and the completion status
value is ignored by sending
0
for the
compStat%
parameter.
EnterNMoreI
SYNTAX
EnterNMoreI(ByVal devHandle%,data%,ByVal count&)As Long
REMARKS
EnterNMoreI
is equivalent to the following call to
EnterXI
:
EnterXI(devHandle%,data%,count&,0,0,0,0);
The
EnterNMoreI
function passes the device handle, the pointer to the data buffer, and the size of the
data buffer to the
EnterXI
function. It specifies
forceAddr%
is
FALSE
; therefore, Driver488 does not
address the device if it is the same device as previously used. The default terminators are chosen by
specifying a
0
as the
term
parameter. Asynchronous transfer is turned off by sending
0
for the
async%
parameter, and the completion status value is ignored by sending
0
for the
compStat%
parameter.
Note:
All forms of the
EnterI
commands (except
EnterXI
) use
EOI
as the only terminator. Also,
EnterI
and
EnterMoreI
must be passed to the entire array (i.e.
intarray()
, not the
starting location:
intarray (0)
).
The following table describes the differences between the various forms of
EnterI
. It outlines the
variables passed to each function and how many bytes the functions read.
EnterI Function
Reads Until
Variable
EnterXI (ADC,IResp (0),1000,1,Term,1,1)
n
bytes or
terminators
Pass starting location
EnterI (ADC, IResp())
EnterMoreI (ADC, IResp ())
Array full or
EOI
Pass entire array
EnterNI (ADC< IResp (0), 1000)
EnterNMoreI (ADC, IResp (0), 1000)
n
bytes or
EOI
Pass starting location
where:
SResp
is
String * 1000
, and
IResp(1000)
is
integer
.