Legacy Document

Inside Macintosh: Devices /

Chapter 2 - Slot Manager / Slot Manager Reference

Slot Manager Routines / Finding sResources

SRsrcInfo

You can use the SRsrcInfo function to find an sResource. This function also provides additional information about the sResource, such as the driver reference number of the slot device driver.

FUNCTION SRsrcInfo (spBlkPtr: SpBlockPtr): OSErr;

spBlkPtr

A pointer to a Slot Manager parameter block.

<--	spsPointer	Ptr	A pointer to an sResource (described in "The sResource," beginning on page 2-7).
<--	spIOReserved	Integer	The value of the slot resource table ioReserved field.
<--	spRefNum	Integer	The device driver reference number.
<--	spCategory	Integer	The Category field of the sRsrcType entry (described on page 2-10).
<--	spCType	Integer	The cType field of the sRsrcType entry.
<--	spDrvrSW	Integer	The DrSW field of the sRsrcType entry.
<--	spDrvrHW	Integer	The DrHW field of the sRsrcType entry.
-->	spSlot	SignedByte	The slot number of the requested sResource.
-->	spId	SignedByte	The sResource ID of the requested sResource.
-->	spExtDev	SignedByte	The external device identifier.
<--	spHwDev	SignedByte	The hardware device identifier.

DESCRIPTION

The SRsrcInfo function allows you to find an sResource from the slot resource table and provides additional information, including its driver reference number and the values contained in its sRsrcType entry.

You specify an sResource with the spSlot, spID, and spExtDev fields of the Slot Manager parameter block you point to in the spBlkPtr parameter.

The SRsrcInfo function returns a pointer to the sResource in the spsPointer field and returns information about the sResource type in the spRefNum, spCType, spDrvrSW, spDrvrHW fields. The function returns other information about the sResource in the spIOReserved, spRefNum, and spHwDev fields.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the SRsrcInfo function are

Trap macro	Selector
_SlotManager	$0016

You must set up register D0 with the routine selector and register A0 with the address of the Slot Manager parameter block. When _SlotManager returns, register D0 contains the result code.

Registers on entry
A0	Address of the parameter block
D0	$0016

Registers on exit
D0	Result code

RESULT CODES

noErr	0	No error
smNoMoresRsrcs	-344	Requested sResource not found

SEE ALSO

For more control in finding sResources, you can use the SGetSRsrc function, described next, and the SGetTypeSRsrc function, described on page 2-35.