Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi - Manual (Page 337)

15B. Driver488/SUB, W31, W95, & WNT III. COMMAND REFERENCES - 15. Command References
III-322 Personal488 User’s Manual, Rev. 3.0
The EnterMore function passes the device handle and the pointer to the data buffer to the EnterX
function. It determines the size of the data buffer provided by the user and passes that value as the
count parameter. 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.
EnterNMore
SYNTAX long pascal EnterNMore(DevHandleT devHandle,char *data,int
count);
REMARKS EnterNMore is equivalent to the following call to EnterX :
EnterX(devHandle,data,count,0,0L,0,0L);
The EnterNMore function passes the device handle, the pointer to the data buffer, and the size of the
data buffer to the EnterX 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.
Enter (Peripheral Mode)
EnterX
SYNTAX long pascal EnterX(DevHandleT devHandle, char *data, long
count,bool forceAddr,TermT*term,bool async,int *compStat);
devHandle refers to either an IEEE 488 interface or an external device.
data is a pointer to the buffer into which the data is read.
count is the number of characters to read.
forceAddr is ignored.
term is a pointer to a terminator structure that is used to set up the input
terminators. If term is set to 0 , the default terminators are used.
async is a flag that allows asynchronous data transfer.
compStat is a pointer to an integer containing completion status information.
RETURNS -1 if error,
otherwise, the number of bytes transferred. The memory buffer
pointed to by the data parameter is filled in with the
information read from the device.
MODE *CA
BUS STATES Determined by the Controller
SEE ALSO Output, Term, Buffered, EOL (Sub-Chapter 15A)
EXAMPLE term.EOI = TRUE;
term.nChar = 1;
term.EightBits = TRUE;
term.termChar[0] = ‘\r’;
bytecount=EnterX(timer,data,1024,0,&term,1,&stat);
In Peripheral mode, the EnterX command receives data from the I/O adapter under control of the
Active Controller. The Active Controller must put Driver488 into the Listen state and configure some
bus device to provide Driver488 with data. The Listen state can be checked with the
Status
command, or can cause an interrupt with the Arm command. A time-out error occurs (if enabled) if
Driver488 does not receive a data byte within the time out period after issuing the EnterX command.
Additional Enter Functions
Driver488 provides additional Enter routines that are short form versions of the EnterX function.
The additional Enter functions are: Enter and EnterN . In Peripheral mode, the device handle must