语音卡三汇光盘jan16cn

1、三汇 CTI 语音卡系列Fax 演示程序目录目录i. ii第 1 章 Fax演示程序简述1功能1运行环境1编译环境2相关文件介绍3操作界面说明4第 2 章 Fax演示程序说明8主程序框图8中继通道状态迁移图8传真通道状态迁移图10附录A技术/销售支持11第i 页本文档属所有。保留对此文件进行修改而不另行通知之权利。承诺所提供的信息为正确且可靠, 但并不保证杭州三汇信息本文件绝无错误。请在使用本产品前, 自行确定所使用的相关技术文件及规格为最新有效之版本。若因贵公司使用本公司之文件或产品, 而需要第利或者著作权等与其配合时, 则应由贵公司负责取得第之产品、专同意及。上,述关于同意及非属本公司应为

2、保证之责任。第ii 页第1章 Fax 演示程序简述Fax 演示程序向您演示如何用三汇板卡来实现传真服务器功能。1.1 功能Fax 演示程序向您示范如何基于三汇传真卡实现下列功能：在多个通道上同时接收传真在多个通道上同时发送传真实现传真设置本方传真的识别码及获取对方传真的识别码设置传真速率设置传真页眉信息，包括如何消除 tif 文件页眉、增加 tif 文件页眉等对中继通道进行一次发送单个文件、一次同时发送多个文件，以及在传真发送过程中追加传真文档1.2 运行环境使用带传真资源的模拟卡构建演示系统环境，如下图所示：模拟中继线或数字中继线PSTN传真机Fax图 1-1架构示意图上图所示的试验环境可以

3、用下列板卡实现：SHT 系列模拟语音卡：SHT-4B/PCI/FAXSHT-8B/PCI/FAX第 1 页SHT-16B/PCISHT-16B-CT/PCI/FAXSHT-16B-CT/cPCI/FAXSHD 系列数字中继语音卡：SHD-30B-CT/PCI/FAXSHD-60B-CT/PCI /FAXSHD-30B-CT/cPCI/ FAXSHD-60B-CT/cPCI/FAX1.3 编译环境Fax_Event_VC 在以下环境中编译通过：visual c+6.0。Fax_Event_C#.NET 在以下环境中编译通过：VS.net2003/C#。Fax_Event_VB.NET 在以下环境

4、中编译通过：VS.net2003/VB。Fax_CallBack_VB.NET 在以下环境中编译通过：VS.net2003/VB。第 2 页1.4相关文件介绍第 3 页目录名称包含文件文件描述Fax_Event_VCshpa3api.h BmpApi.h三汇驱动程序开发提供的头文件SHP_A3.lib bmputil.lib三汇驱动程序开发提供的库文件ShConfig.ini ShIndex.ini本 DEMO 程序的系统配置文件Step1.voc Step2.voc本 DEMO 程序所需的语音文件Fax_Event_Vp Fax_Event_VC.h Fax_Event_VCDLG.cpp

5、Fax_Event_VCDLG.hDlg.cpp Dlg.hFourthDlg.cpp FourthDlg.h SecondDlg.cpp SecondDlg.h StdAfx.cpp StdAfx.h ThirdDlg.cpp ThirdDlg.h ToolDlg.cpp ToolDlg.h编译环境：VC+ 6.0/MFCFax_Event_C#.NETShConfig.ini ShIndex.ini本 DEMO 程序的系统配置文件Step1.voc Step2.voc本 DEMO 程序所需的语音文件Form1.cs ToolWn AssemblyInfo.cs编译环境： VS.net200

6、3/C#Fax_Event_VB.NETShConfig.ini ShIndex.ini本 DEMO 程序的系统配置文件Step1.voc Step2.voc本 DEMO 程序所需的语音文件Form1.vb Shpa3api.vb ToolWnd.vb编译环境： VS.net2003/VB.NET1.5 操作界面说明Fax_Event.exe 成功运行后的操作界面如下图所示：传真过程中发送或接收的字节数中继通道号传真过程中本通道所处的状态主叫号码传真任务执行情况传真通道号传真过程中接收或发送传真文件名传真文件页数对方传真机ID传真接收文件名对所选中继通道进行追加传真文件设置传真接收路径设置追加

7、传真停止传真设置本方传真ID 号图 1-2 Fax_Event.exe 成功运行后的操作界面第 4 页Fax_CallBack_VB.NETShConfig.ini ShIndex.ini本 DEMO 程序的系统配置文件Step1.voc Step2.voc本 DEMO 程序所需的语音文件Form1.vb Shpa3api.vb ToolWnd.vb编译环境： VS.net2003/VB.NET选择“发送传真”选项，将显示如下：发送传真文件设置传真起始文件页传真文件结束页递交传真任务图 1-3 “发送传真”框选择“多文件”，显示如下：发送传真文件设置将设置好的发送传真文件加入至左框中删除左框中

8、所选的传真文件发送传真文件所在路径显示所加入的所有发送传真文件名图 1-4 “多文件”框选择“多文件（设置页码）”，显示如下：发送传真文件设置传真文件起始页传真文件结束页显示所加入的所有发送传真文件名将设置好的发送传真文件加入至左框中删除左框中所选的传真文件图 1-5 多文件（设置页码）框第 5 页选择“增加页眉”选项，将显示如下：待增加页眉的 Tif 文件页眉设置增加页眉后生成的新的 Tif 文件增加页眉图 1-6 “增加页眉”框按下“工具窗口”按钮，将弹出如下框：显示取得的所选文件的页数取得所选文件的页数页眉属性设置设置fBmp_SetHeaderFormat函数所生成页眉的属性图 1-7

9、 “工具窗口”框选择“截掉页眉”选项，将显示如下：第 6 页需将页眉截掉的tif 源文件生成的目标 文件需要截掉的高度Tif 文件中需要截掉页眉的指定页截掉页眉图 1-8“截掉页眉”框第 7 页第2章 Fax 演示程序说明2.1主程序框图Start有消息WM_DESTROY消息判断其他消息收到驱动输出事件Message WM_USER通道类型判断？Exit中继通道传真通道TrunkProc图 2-1 主程序框图2.2中继通道状态迁移图中继通道（包括模拟中继通道和数字中继通道）的状态转移图如下图所示：第 8 页CDialog:WindowProcFaxProcSsmCloseCti等待消息Ssm

10、StartCtiStartATRK_IDLENewFaxTaskSsmPickup SsmAutoDialSsmStopPlayIndex SsmHangupSringingTRK_DIALINGSsmHangupBE_PROC_AutoDialNoIdleFaxChAvailable?lParam=?YesAutoDialFailureRemotckup(voice)F2-ToneYesNoAutoFax?SsmHangupAutoFax?ANoYesASsmPlayIndexString(nCh,1) SsmStartTimerSsmStopTimer SsmHangupE SYS TIM

11、EOUTTRK_PLAY_VOC1RemoteHangupF2-ToneDTMF=1|2SsmStopTimerSsmStopTimerSsmStopTimer SsmPlayIndexString(nCh,2)SsmStopTimerBRemoteHangupTRK_PLAY_VOC2F1-ToneF2-Tone E_PROC_PlayEndSsmStopPlayIndex1SsmStopPlayIndex2DTMF=？SsmTalkWithE_MSG_RCV_FAXSsmTalkWithE_MSG_SEND_FAXTRK_FAXINGRemoteHangupE_MSG_FAX_IDLEE_

12、MSG_OFFLINESsmStopTalkWith SsmHangupA图2-2中继通道状态迁移图图例：s说明： Play_Voice1： Play_Voice2： lParam：消息参数：驱动程序通道状态迁移至：演示程序抛出的事件： 演示程序收到自己产生的事件提示音 1：按 1 接收传真，按 2 发送传真提示音 2：请按启动键E_MSG_ E_MSG_第 9 页F1-ToneSsmPickup2.3 传真通道状态迁移图StartFAX_IDLEE_MSG_RCV_FAXE_MSG_SEND_FAXStardSsmFaxStartReceiveSsmFaxStopE_MSG_OFFLINE FAX_CHECK_ENDE_MSG_FAX_IDLE显示传真成功E_MSG_FAX_IDLE显示传真失败E_PROC_FaxEndFailureInFaxTasklParam?图 2-3 传真通道状态迁移图说明：Stard：开始发送传真，根据发送传真的页码数以及传真的文件数来选择调用发送传真的函数FailureInFaxTask：传真任务失败，失败原因有以下几种：传真页面阶段失败握手阶段失败由于对方按“启动键”