TAPI Messages

Messages are used to notify the application of asynchronous events. All of these messages are sent to the application through the message notification mechanism that the application specified in lineInitializeEx.

The message always contains a handle to the relevant object (phone, line, or call), which the application can determine the type of from the message type.

Certain messages are used to notify the application about a change in an object's status. These messages provide the object handle and give an indication of which status item has changed. The application can call the appropriate "get status" function of the object to obtain the object's full status.

When an event occurs, messages can be sent to zero, one, or more applications. The target applications for a message are determined by a number of different factors including the meaning of the message, the application's privilege to the object, whether or not the application initiated the request for which the message is a direct result, and the message masking that has been set by the application. Note the following points about messages:

• Asynchronous reply messages are only sent to the application that originated the request and cannot be masked.
• Messages that signal the completion of digit or tone generation or the gathering of digits are only sent to the application that requested the digit or tone generation.
• Messages that indicate line or address state changes are sent to all applications that have opened the line, so long as the message has been enabled through lineSetStatusMessages.
• Messages that indicate call state and call information changes are sent to all applications that have a handle to the call.
• Messages that signal a digit detection, tone detection, or media mode detection are sent to the applications that requested monitoring of that event.

This section contains the reference for the following TAPI messages:

Line Device Messages

Phone Device Messages

Formatted Error Messages

Assisted Telephony Messages