Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Creating, Initializing, and Validating a Telephone Record

TELDefault

Initializes a telephone record by filling in the configuration fields with the default values supplied by the telephone tool.

pascal TELErr TELDefault (
                     Ptr *theConfig,
                     short procID,
                     Boolean allocate);

theConfig

A pointer to the configuration details for the telephone tool.

procID

A tool ID returned by the TELGetProcID function.

allocate

A value that indicates whether the telephone tool should allocate space for the configuration information. If the value is true, space is allocated for theConfig in the current heap zone. If the value is false, no memory allocation is performed.

function result

A result code. The result code telNoErr indicates that the function completed without any errors. See "Result Codes" on page 1-58 for a list of other result codes that the Telephone Manager may return.

DESCRIPTION

The TELDefault function provides the settings for the configuration fields (config and oldConfig) when a new telephone record is created by the TELNew or the TELNewWithResult function.

SPECIAL CONSIDERATIONS

Your application might not need to call this function, because it's called automatically by TELNew and TELNewWithResult.