文档库 最新最全的文档下载
当前位置:文档库 › Synway’s MAP API

Synway’s MAP API

三汇map卡通讯函数解析(中文)

SsmGetMaxUsableBoard

Obtains the total number of the boards which are successfully initialized by the driver.

获取所有被驱动程序初始化成功的板卡数量

Format:

格式:

int SsmGetMaxUsableBoard()

Parameter Description: None

参数描述:无

Return Value:

返回值

Function Description:

功能描述:

Obtains the total number of the boards which are successfully initialized by the driver.

获取所有被驱动程序初始化成功的板卡数量

Note: None.

笔记:无

Related Information:

相关信息:

Related Function: SsmGetMaxCfgBoard

相关函数:SsmGetMaxCfgBoard

SsmGetMaxUsableBoard

Obtains the total number of the boards which are successfully initialized by the driver.

获取所有被驱动程序初始化成功的板卡数据

Format:

格式:

int SsmGetMaxUsableBoard()

Parameter Description: None

参数描述:无

Return Value:

返回值:

Function Description:

工程描述:

Obtains the total number of the boards which are successfully initialized by the driver.

获取所有被驱动程序初始化成功的板卡数据

Note: None.

Related Information:

Related Function: SsmGetMaxCfgBoard

SsmStartCti

SsmStartCti is the entry function for the entire SynCti API, used to initialize the SynCTI driver platform and voice boards.

SsmStartCti是整个SynCti接口的入口函数。被用于初始化SynCTI驱动平台和声音板卡

Format:

格式:

int SsmStartCti( LPSTR lpSsmCfgFileName, LPSTR lpIndexCfgFileName)

Parameter Description:

参数描述:

Return Value:

返回值:

Function Description:

功能描述:

It’s the entry of the SynCTI driver program. The following operations will be executed: 是一个SynCTI驱动程序的入口函数。下面的操作将会被函数执行: Initializes the voice board;

初始化声音板卡;

●If lpIndexCfgFileName is not NULL, the preload voice data will be loaded into the

memory from the configuration file ‘lpIndexCfgFileName’;

假如内存索引配置文件名称是空的,预加载的声音数据将被从‘lpIndexCfgFileName’配置文件加载到内存

●Based on the basic information such as the model and quantity of voice board, port

address, and interruption number, it registers and initializes a variety of voice boards and allocates the system resources.

基于基本信息比如像模版和大量的声音板卡,端口,地址,和中断编号,它登记和初始化各种各样的声音板卡和分配的系统资源

●Allocates system resources for voice recording and playback.

为录音和重放分配系统资源。

●Establishes an interrupt service routine (ISR).

建立中断服务程序。

Note:

笔记:

●Only ‘SsmStartCti’ has been called successfully, the other functions in the driver

platform can be called (except SsmGetLastErrMsg and SsmGetLastErrCode).

仅仅在‘SsmStartCti’函数被调用成功的情况下。板卡平台的其他函数才能被调用(如:SsmGetLastErrMsg和SsmGetLastErrCode)

●Before exiting the application program, SsmCloseCti must be called to close the driver

program in order to release the resources occupied by the driver.

在退出应用程序之前,为了释放被驱动占用的资源SsmCloseCti必须被调用去关闭驱动程序

●For detailed information about the configuration file, refer to Chapter 4.

关于配置文件的详细信息,参考第四章。

●If multiple boards have been configured and only a part of them is successfully

initialized, the driver also returns 0. The application program can determine whether all the boards are initialized successfully through the functions SsmGetMaxCfgBoard and SsmGetMaxUsableBoard.

如果许多板卡被配置并且仅仅有部分被初始化成功,驱动也会返回0.应用程序能通

过SsmGetMaxCfgBoard和SsmGetMaxUsableBoard函数终止所有被初始化成功的板卡。

Related Information:

相关信息:

Related Functions: SsmCloseCti, SsmGetMaxCfgBoard , SsmGetMaxUsableBoard

相关函数:

无关函数:

SsmLockMediaCh

Locks the media channel. If a media channel is idle, lock it and obtain available resources on the channel.

如果一个媒体通道是空闲的,锁定这个媒体通道,并且从这个媒体通道获取可利用的资源Format:

格式:

int SsmLockMediaCh(int ch)

Parameter Description:

参数描述:

ch Media channel number //媒体通道号

Return Value:

返回值:

-1 Call failed, the failure reason can be obtained by the function SsmGetLastErrMsg//调用失败。调用失败的原因通过SsmGetLastMsg函数获得

> 0 Call successful //调用成功

Function Description:

功能描述:

If a media channel is idle, lock it and obtain available resources on the channel. To be exact, obtain only the local RTP address and port.

如果一个媒体通道是空闲的,锁定它并从这个通道获取可利用的资源,确切的说是仅仅获取本地RTP(实时传输协议)地址和端口。

Note:

笔记:

This channel must be idle. It will go into the state S_IP_MEDIA_LOCK (with the corresponding value of 160) after this function being called successfully. This function is special to

VoIP resource boards.

这个通道必需是空闲的,他进入通信值为160的状态后这个函数现有的被调用将会成功。这个函数专门用于板卡的互联网协议电话。

Related Information:

相关信息:

Driver version SynCTI Ver. 5.2.0.0 or above

Header Shpa3api.h

Library shp_a3.lib

DLL shp_a3.dll

驱动版本SynCTI Ver. 5.2.0.0 or above

头文件Shpa3api.h

库文件shp_a3.lib

动态库shp_a3.dll

相关文档