Inside Macintosh: Networking /

Chapter 5 - AppleTalk Data Stream Protocol (ADSP)

Using ADSP

This section describes how to use ADSP to

• open and maintain an ADSP connection, including how to
  • initialize the connection end (dspInit)
  • set options that control the behavior of the connection end (dspOptions)
  • open the connection (dspOpen)
  • read (dspRead) and write (dspWrite) data over the connection
  • send an attention code and an attention message to the remote connection end (dspAttention)
  • close the connection (dspClose) and remove it (dspRemove)

• create and use a connection listener, including how to
  • initialize a connection listener (dspCLInit)
  • activate the connection listener, causing it to listen for an open-connection request (dspCLListen), filtering requests that you will accept by restricting network addresses
  • initialize (dspInit) and open (dspOpen) a connection end in response to an open request that you want to accept
  • read (dspRead) and write (dspWrite) data over the connection and close the connection (dspClose)
  • remove the connection listener when you are finished with it (dspCLRemove)

• handle unsolicited connection events using your own user routine

You execute ADSP routines by calling the Device Manager's PBControl function. When you call the PBControl function for an ADSP routine, you provide a pointer to a parameter block of type DSPParamBlock.

You use the parameter block fields to specify the input parameters that ADSP requires to execute the command. The parameter block also includes fields whose values ADSP returns. For a complete description of the DSP parameter block and its fields, see "The DSP Parameter Block" beginning on page 5-38.

---

Subtopics

Allocating Memory for ADSP

Creating and Using a Connection Control Block

Opening and Maintaining an ADSP Connection

Creating and Using a Connection Listener

Writing a User Routine for Connection Events