Legacy Document

Inside Macintosh: Devices /

Chapter 4 - SCSI Manager 4.3 / SCSI Manager 4.3 Reference

SCSI Manager 4.3 Functions / Client Functions

SCSIRemoveRefNumXref

You use the SCSIRemoveRefNumXref function to deregister a device driver with the XPT.

OSErr SCSIAction(SCSIDriverPB *scsiPB);

scsiPB

A pointer to a SCSI driver identification parameter block, which is described on page 4-35.

-->	scsiPBLength	UInt16	The size of the parameter block.
-->	scsiFunctionCode	UInt8	The SCSIRemoveRefNumXref function selector code (0x87).
<--	scsiResult	OSErr	The returned result code.
-->	scsiDevice	DeviceIdent	The device identification record.
-->	scsiCompletion	CallbackProc	Unused. Must be set to nil.

DESCRIPTION

The SCSIRemoveRefNumXref function removes a driver entry from the XPT's driver registration table. You specify the device identification record in the scsiDevice field.

Because this function is always executed synchronously, the scsiCompletion field must be set to nil.

SPECIAL CONSIDERATIONS

The SCSIRemoveRefNumXref function is executed synchronously, and may move memory; you should not call it at interrupt time.

RESULT CODES

noErr	0	No error
scsiQLinkInvalid	-7881	The qLink field was not 0
scsiNoSuchXref	-7882	No driver has been cross-referenced with this device

SEE ALSO

See "Loading and Initializing a Driver," beginning on page 4-11, for more information about how device drivers are registered with the XPT.