Legacy Document

Inside Macintosh: Networking /

Chapter 10 - Link-Access Protocol (LAP) Manager / Using the LAP Manager

Defining Your Own AppleTalk Transition

You can define AppleTalk transitions and use such events to send messages to your own entries in the AppleTalk Transition Queue, or you can define events and make them public for others to use.

You can define your own AppleTalk transition to have any meaning you choose. For example, you might want to call every routine in the AppleTalk Transition Queue each time you open or close a custom protocol stack.

You can use either the ATEvent procedure or the ATPreFlightEvent function to notify all of the routines in the AppleTalk Transition Queue that your AppleTalk transition has occurred. Whereas the ATEvent procedure only calls the routines in
the queue with a transition event, the ATPreFlightEvent function also allows each routine in the AppleTalk Transition Queue to return a result code and other information to your calling routine.

A developer-defined event, as with any event, always begins with an uppercase letter (that is, any value in the range $41 00 00 00 through $5A FF FF FF).

Note

You can call the ATEvent and ATPreFlightEvent routines only at virtual-memory safe time. See Inside Macintosh: Memory for information on virtual memory.