Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Detecting Voice and Silence

TELCAVoiceDetect

Activates or deactivates voice detection on a call appearance.

pascal TELErr TELCAVoiceDetect (
                     TELCAHandle hTELCA, 
                     Boolean VoiceDetectOn);

hTELCA

A handle you provide to the call appearance structure for the call appearance of interest. You can get the handle from the TELSetupCall function (page 4-24).

VoiceDetectOn

A Boolean value. Set this parameter to true if you want to activate voice detection for the call appearance referenced by hTELCA. Set it to false to deactivate voice detection.

function result

A result code.

DESCRIPTION

The TELCAVoiceDetect function activates or deactivates voice detection for the call appearance specified by the hTELCA parameter, according to the value of the VoiceDetectOn parameter. Positive voice detection indicates that the call has been answered on the remote side.

If you call the TELCAVoiceDetect function to activate voice detection, your call appearance message handler gets a telCAVoiceDetectedMsg message when voice is detected on the line. Note, however, that voice detection is not a continuous process; as a result, you get at most only one telCAVoiceDetectedMsg message each time you call TELCAVoiceDetect to activate voice detection.

Typically, you call this function after calling TELConnect (page 4-27) or TELDialDigits (page 4-28) so that your application can smoothly handle the case in which no ring tone is received before the remote party answers the call.