Legacy Document

Inside Macintosh: Devices /

Chapter 2 - Slot Manager / Slot Manager Reference

Slot Manager Routines

This section describes the routines provided by the Slot Manager. Most of the routines in this section are used to locate sResources or read information from an entry in an sResource. Some of the routines allow you to read and set information about expansion cards, such as their parameter RAM values, and others allow you to manipulate Slot Manager data structures, like the slot resource table.

Because the SGetCString, SGetBlock, SGetDriver, SExec, InitSDeclMgr, SInitPRAMRecs, SInitSRsrcTable, and SPrimaryInit functions may allocate memory, your application should not call them at interrupt time; however, your can call any other Slot Manager function at interrupt time.

Because each routine uses a subset of the Slot Manager parameter block fields, each routine reference section includes a list of pertinent fields and how they are used.

-->	fieldName	FieldType	Input field.
<--	fieldName	FieldType	Output field.
<-->	fieldName	FieldType	Input/output field.
X	fieldName	FieldType	Affected field.

The arrows show whether you provide a value in the field, the routine returns a value in the field, or both. The X symbol designates fields that may be affected by the execution of the routine. Any value you store in one of these affected fields may be lost. Also, the meaning of these fields upon completion of the routine is undefined; your application should not depend on these values.

Assembly-Language Note

You can call Slot Manager routines using either the _SlotManager trap macro with a selector or an individual macro name consisting of the routine name preceded by an underscore. For example, you can call the SVersion function using the _SVersion macro. Because every routine name macro is equivalent to the _SlotManager trap macro that specifies the corresponding routine selector, you will need to know the routine selectors to trace your code in MacsBug. The _SlotManager trap macro selector for each routine is included in the routine description and summarized in "Trap Macros," beginning on page 2-99.

---

Subtopics

Determining the Version of the Slot Manager

Finding sResources

Getting Information From sResources

Enabling, Disabling, Deleting, and Restoring sResources

Loading Drivers and Executing Code From sResources

Getting Information About Expansion Cards and Declaration ROMs

Accessing Expansion Card Parameter RAM

Managing the Slot Interrupt Queue