// Tapi14.h

#ifndef __MSM_Tapi14__
#define __MSM_Tapi14__

#define TAPI_CURRENT_VERSION 0x00010004

#include <tapi.h>

//
// 自定義消息，用于向主程序傳遞通信進度
//

#define TAPI_LINECALLSTATE_CONNECTED WM_USER+5

#define WM_TAPI_DIALING			WM_USER+10
#define WM_TAPI_CONNECT			WM_TAPI_DIALING+1
#define WM_TAPI_DISCONNECT		WM_TAPI_DIALING+2
#define WM_TAPI_IDLE			WM_TAPI_DIALING+3	
#define WM_TAPI_STATUS			WM_TAPI_DIALING+4
#define WM_TAPI_CALL_PROCEEDING	WM_TAPI_DIALING+6
#define WM_TAPI_CALL_ACCEPTED	WM_TAPI_DIALING+7
#define WM_TAPI_LINE_REPLY		WM_TAPI_DIALING+8
#define WM_TAPI_VOICE_SUPPORT	WM_TAPI_DIALING+9

//函數返回成功與錯誤常數
#define SUCCESS 0
#define ERRORS	-1


//TAPI版本號常數
#define TAPI_VERSION_1_0 0x00010003
#define TAPI_VERSION_1_4 0x00010004
#define TAPI_VERSION_2_0 0x00020000

//程序中使用的TAPI版本號常數
#define WIN2KTAPIVERSION		TAPI_VERSION_1_4
#define EARLY_TAPI_VERSION		TAPI_VERSION_1_0


/////////////////////////////////////////////////////////////////////////////
// CTapi14 window

class CTapi14
{
protected:
	static CTapi14* MyThis;         //用于保存當前類實例
	HWND  m_hWnd;					//主程序窗口句柄
	HINSTANCE m_hInst;				//主程序實例句柄


	//回調函數使用這些參數，用于表征當前通信狀態
	DWORD m_dwDevice, m_dwMessage,m_dwCallbackInstance;

    DWORD m_dwParam1, m_dwParam2, m_dwParam3;

    HLINEAPP m_LineHandle;	        //TAPI線路句柄
    HCALL m_hCall;		          	//呼叫句柄
    HLINE m_hLine;		          	//線路句柄 
	HANDLE m_hComm;					//comm句柄
	DWORD m_dwLines;				//有效的線路/設備個數
	LINECALLPARAMS m_LineParams;	//通信參數結構變量
	
	int  m_nDevice;
	long m_nPrivilege;
	long m_nMediaMode;

    DWORD m_dwAPIVersion;			//API版本號
    char m_szPhoneNumber[64];		//呼叫電話號碼
    char m_szMessage[128];			//TAPI信息字符串

// Construction
public:
	CTapi14();

// Attributes
public:
// Operations
protected:
// Overrides
	// protected virtual functions
    virtual void TapiCallBack();                 //回調函數體
    virtual void HandleCallState();              //處理呼叫狀態的函數

protected:
	void SetCallbackParams(                      //設置回調參數函數
				DWORD dwDevice, DWORD dwMsg, 
				DWORD dwCallbackInstance, 
				DWORD dwParam1, DWORD dwParam2, 
				DWORD dwParam3);
	void Delay(UINT lFactor);                    //延時函數
	void SetVarProps(HWND hWnd, DWORD hDevice ); //設置變量屬性函數
	LONG LineStateConnected();                   //處理線路已連接的函數

public:
// Overrides
	//
	// public virtual functions
	//
	virtual void Create(HWND& hWnd);             //創建函數
	virtual LONG DialCall( CString PhoneNumber );//撥號函數
    virtual LONG HangupCall();                   //掛機函數
	
// Implementation
public:
	virtual ~CTapi14();
	void TapiStatus(LPSTR lpszError,            //發布TAPI狀態的函數
				BOOL bShowMsgBox=FALSE);
	LPSTR GetTapiStatus() const                 //獲取TAPI狀態的函數
	{
		return (LPSTR)m_szMessage;
	}
	// static functions
    static void CALLBACK lineCallbackFunc(      //回調函數，由TAPI自動調用
								DWORD dwDevice,
								DWORD dwMessage,
								DWORD dwCallbackInstance, 
								DWORD dwParam1,
								DWORD dwParam2, 
								DWORD dwParam3);
};

#endif // __MSM_Tapi14__

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