Legacy Document

Inside Macintosh: Devices /

Chapter 4 - SCSI Manager 4.3 / SCSI Manager 4.3 Reference

SCSI Manager 4.3 Functions / Client Functions

SCSIGetVirtualIDInfo

You can use the SCSIGetVirtualIDInfo funtion to get the device identification record 
for a virtual SCSI ID.
OSErr SCSIAction(SCSIGetVirtualInfoPB *scsiPB);

scsiPB

A pointer to a SCSI virtual ID information parameter block, which is described on page 4-34.

-->	scsiPBLength	UInt16	The size of the parameter block.
-->	scsiFunctionCode	UInt8	The SCSIGetVirtualIDInfo function selector code (0x80).
<--	scsiResult	OSErr	The returned result code.
<--	scsiDevice	DeviceIdent	The device identification record.
-->	scsiCompletion	CallbackProc	Unused. Must be set to nil.
-->	scsiOldCallID	UInt16	The virtual SCSI ID to search for.
<--	scsiExists	Boolean	Returns true if the scsiDevice field contains a valid device identification record.

DESCRIPTION

The SCSIGetVirtualIDInfo function returns the device identification record of a device on the virtual bus. This function is typically used by a device driver during the transition from a ROM-based original SCSI Manager to SCSI Manager 4.3. If a device with the specified SCSI ID is not found on the virtual bus, or the device exists but is not accessible through the SCSI Manager 4.3 interface, the scsiExists field returns false and the scsiDevice field should be ignored.

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

RESULT CODES

noErr	0	No error
scsiTIDInvalid	-7868	The target ID is invalid
scsiPBLengthError	-7872	The parameter block is too small for this SIM
scsiQLinkInvalid	-7881	The qLink field was not 0