tma4drv.h

包括语音识别和数字TTS 设置语音识别内容的列表

/*****************************************************************************

	FILE ........... TMA4Driver.H
	FUNCTION ....... Header file for TelephoneMate - TelephoneMate API
	VERSION ........ 2.2
	COMPANY......... Quanova

*****************************************************************************/
 
#ifndef __TMA4DRIVER_H__
#define __TMA4DRIVER_H__


#include "A4Drv.h"

#ifndef _TMM_NOTLINKLIB_

#ifdef _DEBUG
	#pragma comment(lib,"e:\\project\\telmate\\dlib\\TmA4Drv.lib")	
	#pragma message("\tlink   /debug TmA4Driver.lib")
#else
	#pragma comment(lib,"e:\\project\\telmate\\rlib\\TmA4Drv.lib")	
	#pragma message("\tlink   /rlib TmA4Driver.lib")
#endif

#endif


/***************************************************************
//
//
//	修改入口参数类型，把以前为int的参数改成long型
//  目的：为兼容vb,delphi中有int为16位的情况。
//  在C++下int 为32位。现在统一使用long 32位
//
***************************************************************/



//////////////////////////////////////////////////////////////////
//
//注意：
//改进，加快回调速度
//long	TELMATEFUNC TV_StartPlayBuf(char *pBuf,long lSize,void *pParam,CallBack_PlayMix PlayFunc,BOOL bAutoReset);
// 回调函数类型为CallBack_PlayMix 参数类型为*pTmPlayState.
//
//
//
//
//
//////////////////////////////////////////////////////////////////////////////////


#ifdef __cplusplus
extern "C" {
#endif

#ifndef WIN32
#define TELMATEFUNC
#else
#define TELMATEFUNC	WINAPI
#endif

/************************************************/
// Function:			开发包接口函数说明
//
//*********************************************/


//////////////////////////////////////////////////////////////////////////
//
// Function:		
//
// Date:
//
// Description:	    
//
// Inputs:          
//
// Return:         
//		 
// Notes:	
// 
//////////////////////////////////////////////////////////////////////////



/*************************************************************************/
//
//
//						初始化、设备信息相关函数
//
//
/*************************************************************************/

//////////////////////////////////////////////////////////////////////////
//
// Function:		DLL_Version
//
// Description:	    取得DLL当前版本
//
// Inputs:          
//
// Return:          DLL版本
//
// Notes:			
// 
//////////////////////////////////////////////////////////////////////////
unsigned long	TELMATEFUNC	  Tma4drv_DLL_Version();



//////////////////////////////////////////////////////////////////////////
//
// Function:		TV_GetInitState
//
// Description:	    取得初始化状态
//
// Inputs:          无
//
// Return:          
//		TRUE:		初始化设备成功
//	    FALSE:		初始化设备失败
// Notes:			
// 
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_GetInitState ();

//////////////////////////////////////////////////////////////////////////
// 
// Function:		TV_Initialize
//
// Description:	    初始化设备
//
// Inputs:          无
//
// Return:          
//		 0:失败，没有找到设备，或者是没有安装设备的驱动
//		 1:成功
//
// Notes:	在使用设备前一定要先初始化设备。
// 
//////////////////////////////////////////////////////////////////////////
long		TELMATEFUNC TV_Initialize ();

///////////////////////////////////////////////////////////////////////////////
//
// Function:			TV_Initialize2
//
// Date:				2004/12/15
//
// Description:			初始化设备
//
//
// Inputs:          
//		bWaitForInsert:TRUE 如果打开设备失败（没有接设备）是否等待插入设备后自动打开
//		bWaitForInsert:FALSE 打开设备失败返回后如果插入设备不会自动打开设备。需要在插入设备后再初始化
//
// Return:              
//		 0:失败，没有找到设备，或者是没有安装设备的驱动
//		 1:成功
//
// Notes:	
//		如果bWaitForInsert == TRUE.那此函数等价与TV_Initialize		
//		TV_Initialize2和TV_Initialize两个只需要选择其中一个初始化设备
//		如果设备能被正常打开这两个函数就完全等价
///////////////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_Initialize2(BOOL bWaitForInsert);

///////////////////////////////////////////////////////////////////////////////
//
// Function:			TV_InitializeEX
//
// Date:				2006/05/15
//
// Description:			初始化设备
//
//
// Inputs:          
//		dwDeviceType:		指定要打开的玻瑞器设备类型（只支持玻瑞器）。
//							A4DRVM.H里有玻瑞器设备类型的定义
//							0或者不是玻瑞器设备：表示打开全部类型的设备
//		bWaitForInsert:TRUE 如果打开设备失败（没有接设备）是否等待插入设备后自动打开
//		bWaitForInsert:FALSE 打开设备失败返回后如果插入设备不会自动打开设备。需要在插入设备后再初始化
//
// Return:              
//		 0:失败，没有找到设备，或者是没有安装设备的驱动
//		 >0:成功打开的设备数量
//
// Notes:	
//		如果bWaitForInsert == TRUE.那此函数等价与TV_Initialize		
//		TV_Initialize2和TV_Initialize两个只需要选择其中一个初始化设备
//		如果设备能被正常打开这两个函数就完全等价
///////////////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_InitializeEX(DWORD dwDeviceType,BOOL bWaitForInsert);


//////////////////////////////////////////////////////////////////////////
//
// Function:		TV_Disable
//
// Description:	    关闭设备
//
// Inputs:          无
//
// Return:          无
//
// Notes:			在退出程序前必须调用此函数来关闭设备。
// 
//////////////////////////////////////////////////////////////////////////
void	TELMATEFUNC TV_Disable ();

//////////////////////////////////////////////////////////////////////////
//
// Function:		TV_ReInit
//
// Description:	    重新初始化设备
//
// Inputs:          无
//
// Return:         
//		 TRUE:		成功
//		 FALSE:		失败
//
// Notes:	建议收到在设备读写错误的消息后重新初始化设备
// 
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_ReInit();


//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_RegMsgWnd
//
// Description:			注册接受事件消息的窗口
//
// Inputs:          
//		 hWnd:窗口句柄
//		 bType:FALSE共享方式，其它以前注册过的窗口都可以收到消息
//		 bType:TRUE独占方式，其它注册过的窗口都将不能收到消息。使用完毕后务必要反注册掉
//		//不然将只有此窗口能接受消息
// Return:              
//		TRUE:			注册成功
//		FALSE:			注册失败
// Notes:	
//			
//
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_RegMsgWnd(HWND hWnd,BOOL bType);

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_UnRegMsgWnd
//
// Description:			取消注册的接受事件消息的窗口
//
// Inputs:          
//		 hWnd:			窗口句柄
//		 bType:FALSE	共享方式注册的窗口
//		 bType:TRUE		独占方式注册的窗口
// Return:              
//		TRUE:			反注册成功
//		FALSE:			反注册失败，没有注册过此窗口
// Notes:	
//			
//
//////////////////////////////////////////////////////////////////////////
BOOL    TELMATEFUNC TV_UnRegMsgWnd(HWND hWnd,BOOL bType);

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetSerial
//
// Description:	        取得板卡序列号
//
// Inputs:              保存序列号的内存缓冲地址
//
// Return:              无
//
// Notes:				正确打开设备以后才能取得序列号，序列好长度为6位数字。
//						所以缓冲长度必须大于6。
//						适用型号为1的板卡.
//
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_GetSerial (char *pBuf);


//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetSerial2
//
// Date:				2005/01/29
//
// Description:	        取得板卡序列号
//
// Inputs:              
//
// Return:              板卡序列号
//
// Notes:				
//						适用型号为2的板卡
// 
//////////////////////////////////////////////////////////////////////////
DWORD	TELMATEFUNC TV_GetSerial2();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetSerial2_BK
//
// Date:				2005/12/28
//
// Description:	        取得玻瑞器第二位置备份的序列号（目前未使用，为0）
//
// Inputs:              
//
// Return:              板卡序列号
//
// Notes:				
//						只能适合玻瑞器型号的设备
// 
//////////////////////////////////////////////////////////////////////////
DWORD	TELMATEFUNC TV_GetSerial2_BK();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetDevicePwd
//
// Date:				2005/12/28
//
// Description:	        取得玻瑞器的设备密码
//
// Inputs:              
//
// Return:              密码值
//
// Notes:				
//						只能适合玻瑞器型号的设备
// 
//////////////////////////////////////////////////////////////////////////
DWORD	TELMATEFUNC TV_GetDevicePwd();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetDevicePwd_BK
//
// Date:				2005/12/28
//
// Description:	        取得玻瑞器第二位置备的设备密码（目前未使用，为0）
//
// Inputs:              
//
// Return:              密码值
//
// Notes:				
//						只能适合玻瑞器型号的设备
// 
//////////////////////////////////////////////////////////////////////////
DWORD	TELMATEFUNC TV_GetDevicePwd_BK();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_DisableDevicePointSign
//
// Date:				2005/12/28
//
// Description:	        设置玻瑞器设备的积分标记为不可用。出厂默认为可TRUE，
//
// Inputs:              
//
// Return:              
//		TRUE:			成功
//		FALSE:			失败
// Notes:				
//						只能适合玻瑞器型号的设备
//						写入后不能被再次启动可用。
//						也就只要被设置过不可用，以后永远都是不可用的标记.
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_DisableDevicePointSign();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetDevicePointSign
//
// Date:				2005/12/28
//
// Description:	        得到玻瑞器设备的积分标记状态(保留，未使用)
//
// Inputs:              
//
// Return:              
//		TRUE:			成功,还没有积分过
//		FALSE:			失败,已经被积分过了
// Notes:				
//						只能适合玻瑞器型号的设备
//						
//////////////////////////////////////////////////////////////////////////
BOOL	TELMATEFUNC TV_GetDevicePointSign();

//////////////////////////////////////////////////////////////////////////
//
// Function:			TV_GetDeviceID
//
// Date:				2005/01/29
//
// Description:	        取得板卡型号
//
// Inputs:              
//
// Return:              板卡型号.具体ID定义可查看A4Drv.h中的设备类型定义
//
// Notes:				
//						目前2005年1月后的板卡返回2,以前的返回1
//
//						具体ID定义可查看A4Drv.h中的设备类型定义
//////////////////////////////////////////////////////////////////////////