tw8aw.doc

电信语音系统源码

		 TurboWay Windows 3.1 编程接口简要说明

			版本 1.00 (1995. 3)


编程接口软件包中的文件说明
==========================
	
	TW8AW.DOC       - 你正在阅读的文件
	TW8A_C.DOC      - C 语言编程接口函数说明
	TW8AW.DLL       - 动态连接库 (由 Borland C++ 3.1 编译)
	TW8AW.LIB       - TW8AW.DLL 的输入库
	TW8AW.H         - 编程接口头文件

	TWDEMOW.C       - 多通道编程范例
	TWDEMOW.H
	TWDEMOW.RC
	TWDEMOW.DEF
	TWDEMOW.EXE

	SWITCHW.C       - 交换机演示程序
	SWITCHW.H
	SWITCHW.RC
	SWITCHW.DEF
	SWITCHW.EXE

	TW8A.EXE        - TurboWay 驱动程序


使用方法
========

在使用此接口时, 用户 C 语言源代码中要包含接口头文件:

	#include "TW8AW.H"

并且把源程序和 TW8AW.LIB 一起编译连接, 这样, C 语言源代码中就可以直接
使用动态连接库 TW8AW.DLL 所提供的库函数. 在编译源程序时, 应使用大模式
方式, 编译器可以是 Borland C++ for Windows, Visual C++ 等, 如果使用
Visual Basic 编程, 动态连接库的使用方法请参阅相应的 Visual Basic 用户
手册.

应用程序在运行时需要找到文件 TW8AW.DLL, 请将 TW8AW.DLL 放入到 Windows
子目录或 Windows 系统子目录 (如 C:\WINDOWS, C:\WINDOWS\SYSTEM).

在进入 Windows 前, 要在 MS-DOS 环境下运行 TW8A.EXE, 这样在 Windows 中
才能够使用 TurboWay 电话卡.


与 MS-DOS 编程接口的差别
========================

Windows 编程接口中的 C 语言函数与 MS-DOS 下的函数基本一致, 具体的函数
列表及使用方法请参看手册, 这里仅列出与 MS-DOS 下 C 语言接口中的不相同
的内容.

录放音函数
----------
TW_StartPlay(...) 和 TW_StartRecord(...) 与 MS-DOS 编程接口中的参数已不
一样, 在 Windows 下不要调用这两个函数, 请使用 TW_StartPlayFile(...) 和
TW_StartRecordFile(...)

参数控制块
----------
在 Windows 中, 请使用 TW_GetPcb(...) 和 TW_SetPcb(...) 来读写 PCB_STRUC
中的数据.

全局变量
--------
请使用 TW_SetClose(...) 设置变量 TW_CloseFile 的值, TW_SetLength(...)
设置变量 TW_BufLength 的值, TW_SetVoice(...) 设置 TW_VoiceData 的值,
变量 TW_VoiceLen 已被取消. 这样, 函数 TW_StartPlaySentence(...) 中所
使用的声音数据都放在文件中, TW_VoiceData 指向的都是声音文件名.


新增函数
========

int FAR PASCAL TW_SetClose (int);
---------------------------------
功能: 设置变量 TW_CloseFile 的值
参数: 所要设置的值 (0/1)
返回: TW_CloseFile 原来的值
说明: 如果要求同时录放音的文件数太多, 建议先试一试使用 Windows 的函数
      SetHandleCount(...) 来增加允许同时打开的文件数

int FAR PASCAL TW_SetLength (int);
----------------------------------
功能: 设置变量 TW_BufLength 的值
参数: 所要设置的值
返回: TW_BufLength 原来的值
说明: 在 Windows 编程接口中, TW_BufLength 的缺省值为 0x1000

void FAR PASCAL TW_SetVoice (LPSTR *);
--------------------------------------
功能: 设置变量 TW_VoiceData 的值(指针)
参数: 所要设置的值
返回: 无

void FAR PASCAL TW_GetPcb (PCB_STRUC far *);
--------------------------------------------
功能: 读取系统参数控制块 PCB_STRUCT 的值
参数: 存放参数值的结果指针
返回: 无

void FAR PASCAL TW_SetPcb (PCB_STRUC far *);
--------------------------------------------
功能: 设置系统参数控制块 PCB_STRUCT 的值
参数: 所要设置的参数控制块的指针
返回: 无


编程策略
========

MS-Windows 是一个多任务系统, 系统中可能在同时运行多个进程, 因此, 在编制
Windows 应用程序时, 要考虑到与其他进程的配合, 所编制的应用程序要使自己
正常工作, 也不能影响正在运行的其他任务的正常工作

建议在 Windows 应用程序的主窗口中建立一个时钟 (调用 Windows 的系统函数
SetTimer), 时钟的周期可以根据系统情况来调整, 例如可以设置为 50 毫秒,
这样主窗口函数可以在消息 WM_TIMER 中处理各种事务, 具体方法可以参照实例
程序 TWDEMOW.C

当 Windows 系统处于比较忙的状态时(例如和磁盘进行交换), 如果电话卡正在进
行录放音, 可能会有短暂的间断现象, 这是正常的, 但是在一般情况下, 如果应用
程序在录放音时经常有明显的间断现象, 这就需要调整时钟的频率, 例如将消息
WM_TIMER 调整到更小的时间, 也可以调用函数 TW_SetLength(...) 适当增大放音
缓冲区的长度变量 TW_BufLength 的值


重要信息
========

在使用 MS-Windows 编程接口前, 建议您先了解一下更多的有关 TurboWay 的知识,
这样有助于您设计出优秀的 MS-Windows 下的应用软件. 请参阅北京泰兴数据工程 
有限公司提供的 TurboWay 用户手册.

如果在使用本接口时有疑问或建议, 请直接与我们取得联系:

	地址: 100080 北京市中关村路 56 号
		  北京泰兴数据工程有限公司

	电话: [phone]
	传真: [phone]

				北京泰兴数据工程有限公司
				
				March 31, 1995
				July 21, 1995