Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Devices /
Chapter 4 - SCSI Manager 4.3 / SCSI Manager 4.3 Reference
SCSI Manager 4.3 Functions / Client Functions


SCSIResetDevice

You use the SCSIResetDevice function to reset a SCSI device.

OSErr SCSIAction(SCSI_PB *scsiPB);
scsiPB
A pointer to a SCSI Manager parameter block.
-->scsiPBLengthUInt16The size of the parameter block.
-->scsiFunctionCodeUInt8The SCSIResetDevice function selector code (0x12).
<--scsiResultOSErrThe returned result code.
-->scsiDeviceDeviceIdentThe device identification record.
-->scsiCompletionCallbackProcA pointer to a completion routine. If set to nil, the function is executed synchronously.
-->scsiDriverStorageUInt8 *Optional pointer to the device driver's private storage.

DESCRIPTION
The SCSIResetDevice function attempts to send a BUS DEVICE RESET message to the target. If the device is currently on the bus, the SIM asserts the /ATN signal and sends the message at the next message-out phase. If the target is not on the bus, the SIM selects it and sends an IDENTIFY message followed by a BUS DEVICE RESET message.

SPECIAL CONSIDERATIONS
The BUS DEVICE RESET message clears all I/O transactions for all logical units of the target device. This function may result in data loss and should be used only to restore operation in the event that a device fails to respond to other messages.

RESULT CODES
noErr0No error
scsiBusInvalid-7869The bus ID is invalid
scsiRequestInvalid-7870The parameter block request is invalid
scsiPBLengthError-7872The parameter block is too small for
this SIM
scsiQLinkInvalid-7881The qLink field was not 0
scsiMessageRejectReceived-7923REJECT message received

Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996