Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Telephone Terminals Functions / Monitoring and Controlling Telephone Terminals

TELAlert

Rings a terminal.

pascal TELErr TELAlert (
                     TELHandle hTEL, 
                     short *level, 
                     short alertPattern);

hTEL

A handle to a telephone record associated with a telephone terminal.

level

On entry, a value that indicates the desired volume level of the specified alert pattern. On exit, a value that indicates the actual volume level of that pattern.

alertPattern

An alerting pattern. See "Alerting Patterns" on page 2-15 for the values you can pass in this parameter.

function result

A result code.

DESCRIPTION

The TELAlert function causes the terminal specified by the hTEL parameter to alert by emitting the ringing pattern specified by the alertPattern parameter at the volume level specified by the level parameter. The value specified in the level parameter should be between telVolMin and telVolMax. You can also pass the value telVolSame to have the volume remain at its current level.

Alerting patterns are terminal-dependent. To determine which alerting patterns and volume levels a terminal supports, inspect the ringerTypes and ringerVol fields of the telephone terminal record associated with the hTEL parameter.

SPECIAL CONSIDERATIONS

The TELAlert function controls only the ringer of a telephone terminal, not those provided by applications.