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


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.
-->scsiPBLengthUInt16The size of the parameter block.
-->scsiFunctionCodeUInt8The SCSIGetVirtualIDInfo function selector code (0x80).
<--scsiResultOSErrThe returned result code.
<--scsiDeviceDeviceIdentThe device identification record.
-->scsiCompletionCallbackProcUnused. Must be set to nil.
-->scsiOldCallIDUInt16The virtual SCSI ID to search for.
<--scsiExistsBooleanReturns 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
noErr0No error
scsiTIDInvalid-7868The target ID is invalid
scsiPBLengthError-7872The parameter block is too small for this SIM
scsiQLinkInvalid-7881The qLink field was not 0

Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996