System Messages; Start-Up And Shutdown Of Tapi - Toshiba Strata DK40 Installation & Maintenance Manual

System Messages

System Messages
An application receives information in two ways; solicited and unsolicited. Solicited
information is requested by the application through a function call such as lineGetDevCaps or
lineGetAddressCaps. Unsolicited information arrives in the form of messages. Often, the
two mechanisms are used together, as when application receives a LINE_CALLSTATE
message, after which it checks the information contained in the LINECALLINFO structure
by calling lineGetCallInfo.
Strata DKT TSPI supports the following messages providing unsolicited information.
LINE_CALL STATE
Sent to an application to notify it about changes in a call's state.
LINE_LINEDEVSTATE
Sent to the application to notify it about changes in the line status. This message indicates
which status item has changed.
LINE_ADDRESSSTATE
The Service Provider follows with this call-back message giving changes to the state of any
address.
LINE_CALLINFO
A call-back message that notifies of additional information about the call.
LINE_REPLY
Messages generated for all asynchronous requests. Toshiba DKT TSPI always uses
lineMakeCall in this asynchronous manner.
LINE_NEWCALL
A message to notify the application of a new call event arriving.

Start-up and Shutdown of TAPI

lineInitialize
An application registers a TAPI connection by calling this function. This function is not
passed through to the TSPI but handled by TAPI.DLL. One of the main purposes is to
establish a pointer to the application's call-back function to allow unsolicited messages to be
registered. Two pieces of information are returned to the application: an application handle
and the number of available line devices. Strata DK TSPI supports multiple line devices.
Strata DK40 I&M Manual Spring 1999
Refer to the Strata DK40 Programming Manual or DK Library CD-Rom for more details.
Computer Telephony Integration
8-11