Specifications

CHAPTER 4
Software Support
Detecting Errors 71
Upon return, the parameters are set as follows:
The caller passes a pointer to the user-defined procedure and to a parameter that is
passed to that procedure in the A1Param value. The control routine returns the previous
values. Calling rsSetNotificationProc with a NULL pointer disables the notification
procedure.
When the user-defined procedure is called, the D0.w register contains the event and the
A1 register contains the A1Param value. The procedure can use registers D0–2 and A0–1.
The events are listed inTable 4-3.
rsLastError 4
You can use the rsLastError status routine to obtain the last nonzero error code
returned.
The status code for this routine is rsLastError = 702.
Parameter block
—> indicates input to the driver
<— indicates output from the driver
<— csParam+0 long Pointer to the previous notification procedure.
<— csParam+4 long Previous A1Param value.
Table 4-3 Special events
Event Description
rsPrintSpoolErr Problem opening or writing to a print spool file
rsCOM1SpoolErr Problem opening or writing to the COM1 spool file
rsCOM2SpoolErr Problem opening or writing to the COM2 spool file
rsDiskFileErr Problem reading the disk file
—> ioCompletion long Pointer to the completion routine.
<— ioResult word Device driver’s result code.
—> ioRefNum word Device driver’s reference number.
—> csCode word Equals rsLastError.
<— csParam+4 long Pointer to the last error routine.