Legacy Document

Inside Macintosh: Networking /

Chapter 5 - AppleTalk Data Stream Protocol (ADSP) / ADSP Reference

Routines

This section describes the ADSP and ASDSP routines that you use to

• establish and terminate an ADSP connection
• establish a secure (ASDSP) connection
• establish and terminate an ADSP connection listener
• maintain an ADSP connection, including sending and receiving data across an ADSP or ASDSP connection and enabling encryption of the data to be sent

You use the Device Manager's PBControl function for all of the ADSP and ASDSP routine calls.

FUNCTION PBControl (paramBlock: ParmBlkPtr; 
                     async: Boolean): OSErr;

paramBlock

A pointer to the DSP parameter block that the PBControl function uses for DSP routines.

async

A Boolean that specifies whether the function is to execute synchronously or asynchronously. Set the async parameter to TRUE to execute the function asynchronously.

DESCRIPTION

All of the ADSP routines are implemented through a call to the PBControl function. The PBControl function takes a pointer to a parameter block and a Boolean value that specifies the mode in which the function is to be executed. You use the DSP parameter block for all ADSP calls.

The parameter block includes a field, csCode, in which you specify the routine selector for the particular routine to be executed; you must specify a value for this field. Each ADSP routine may use different fields of the DSP parameter block for parameters specific to that routine. The description of a function in this section includes the specific parameters used for that function. See the section "The DSP Parameter Block" beginning on page 5-38 for the complete DSP parameter block data structure.

An arrow preceding a parameter indicates whether the parameter is an input parameter, an output parameter, or both:

Arrow	Meaning
-->	Input
<--	Output
<->	Both

---

Subtopics

DESCRIPTION

Establishing and Terminating an ADSP Connection

Establishing and Terminating an ADSP Connection Listener

Maintaining an ADSP Connection and Using It to Exchange Data