=======================================================================
       tapisample - A TAPI 2 Sample Application
========================================================================

This application provides an example of how to use all of the main 
functions supported by the IP Office Telephony Server Provider (TSP).
It presents a dialog packed full of buttons representing the functions
that can be performed.  A window shows the details of the TAPI events
that occur.

The IP Office TSP can operate in first party mode (single user) or third
party mode.  In first party mode, the application controls and monitors
the single users extension.  In third party mode, the application
controls the extension relating to the first TAPI line opened, however
the selected extension can be changed using the edit box and Select
button. In third party mode, the application will monitor and show 
events for all extensions.

The meaning of most of the buttons are obvious, however a few are worth
explaining:

Clear Display clears the event window (that's fairly obvious).
Hide will hide the entire dialog box. It will only reappear when a call
is received, or if the user clicks on the icon in the system tray.


The dialog has an unlabeled edit box which is used to supply
information to some of the buttons as follows:

Make Call takes the target phone number from the edit box
Park and Unpark take the park id from the edit box
Divert Destination takes the divert destination from the edit box
Msg Waiting Lamp takes the numbers of messages from the edit box,
	If zero, the lamp is extinguished, if > zero, the lamp is lit
Dial takes the number to dial from the edit box
Blind Transfer takes the transfer target from the edit box
Redirect takes the redirect target from the edit box
Log On takes the log on id from the edit box
Set App Specific takes the app specific value from the edit box

========================================================================

The remainder of this readme gives a brief explanation of the structure
of the software.


AppWizard created this tapisample application.

This file contains a summary of what you will find in each of the files that
make up the tapisample application.

tapisample.h
    This is the main header file for the application.  It includes other
    project specific headers (including Resource.h) and declares the
    CTapisampleApp application class.

tapisample.cpp
    This is the main application source file that contains the application
    class CTapisampleApp.

tapisample.rc
    This is a listing of all of the Microsoft Windows resources that the
    program uses.  It includes the icons, bitmaps, and cursors that are stored
    in the RES subdirectory.  This file can be directly edited in Microsoft
	Developer Studio.

res\tapisample.ico
    This is an icon file, which is used as the application's icon.  This
    icon is included by the main resource file tapisample.rc.

res\tapisample.rc2
    This file contains resources that are not edited by Microsoft 
	Developer Studio.  You should place all resources not
	editable by the resource editor in this file.

res\splash.bmp
    This file contains the bitmap for the splash screen.

/////////////////////////////////////////////////////////////////////////////

AppWizard creates one dialog class:

tapisampleDlg.h, tapisampleDlg.cpp - the dialog
    These files contain your CTapisampleDlg class.  This class defines
    the behavior of the application's main dialog.  The dialog's
    template is in tapisample.rc, which can be edited in Microsoft
	Developer Studio.

A class has been added to provide a splash screen:

splash.h, splash.cpp - the splash screen
    These files contain the CSplashWnd class, created by ClassWizard.

The TAPI functionality has been added in the following files:

tapiline.h, tapiline.cpp, tapidescribe.h, tapidescribe.cpp
    These files contain the TapiLine and TapiApplication classes and
	general purpose helper functions.

/////////////////////////////////////////////////////////////////////////////
Other standard files:

StdAfx.h, StdAfx.cpp
    These files are used to build a precompiled header (PCH) file
    named tapisample.pch and a precompiled types file named StdAfx.obj.

Resource.h
    This is the standard header file, which defines new resource IDs.
    Microsoft Developer Studio reads and updates this file.

/////////////////////////////////////////////////////////////////////////////
Other notes:

If your application uses MFC in a shared DLL, and your application is 
in a language other than the operating system's current language, you
will need to copy the corresponding localized resources MFC40XXX.DLL
from the Microsoft Visual C++ CD-ROM onto the system or system32 directory,
and rename it to be MFCLOC.DLL.  ("XXX" stands for the language abbreviation.
For example, MFC40DEU.DLL contains resources translated to German.)  If you
don't do this, some of the UI elements of your application will remain in the
language of the operating system.

/////////////////////////////////////////////////////////////////////////////