润普专业电话录音系统、电话录音卡使用说明书和开发手册

函数说明

。初始化操作的函数

函数名称：bool WINAPI SW_Init( )

入口参数： 无

函数返回： true - 正确返回 false - 错误。

功能描述： 初始化USB电话录音盒。在程序开始时调用。

函数名称：bool WINAPI SW_Free( )

入口参数： 无

函数返回： true - 正确返回 false - 错误。

功能描述： 关闭USB电话录音盒。在程序退出时调用。

函数名称：void WINAPI SW_SetType(int DeviceType)

入口参数： DeviceType 设备类型

1 - RL1/RL4/CID1/CID4 1线/4线录音/1/4线主叫号码盒

2 - RL2/CID2 2线录音/2线主叫号码接收设备

3 - SW1/SW4 1线/4线电话答录终端

4 - RL8/RL16/RL12 8线/16线电话录音盒

函数返回： 无

功能描述： 设置USB电话设备的类型，一般在初始化后调用该函数.

。状态函数

函数名称：int WINAPI SW_GetCount()

入口参数： 无

函数返回： 系统连接的USB电话录音盒的数量。-1:错误 精品

功能描述： 得到USB电话录音盒的数量，在连接多个设备时来区分不同的设备。 可依据序列号来判断不同录音盒的设备号，序列号小的相应的设备号为0

函数名称：int WINAPI SW_GetSN(int nIndex)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 设备序列号。-1:错误

功能描述： 得到USB电话录音盒的序列号.

。摘挂机检测函数

函数名称：int WINAPI SW_ CheckDisconnect (int nIndex)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 0-以接上 1-未接上或断线 -1 错误。

功能描述： 检查电话线是否插到设备上或断线指示。

函数名称：int WINAPI SW_CheckRing(int nIndex)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 0-未振铃 1-振铃 -1 错误。

功能描述： 电话振铃检测。

函数名称：int WINAPI SW_CheckOffHook(int nIndex)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 0-挂机 1-摘机 -1 错误。

功能描述： 得到电话线路的摘挂机状态。

。录音函数

函数名称：long WINAPI SW_CheckFileRecordEnd (int nIndex) 精品

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 返回未录完的字节数，0-录音结束。

功能描述： 检测文件录音是否结束，与SW_StartFileRecord ()函数配合使用，完成录音功能。

函数名称：int WINAPI SW_StartFileRecord (int nIndex, char *FileName,

DWORD FileLength)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个

设备时，为0

FileName 录音文件名称，默认为WAV文件，可直接通过声卡

播放，不需要转换。

FileLength 文件长度

函数返回： 0 - 正确返回 -1 - 错误。

功能描述： 文件录音，默认数据格式为WAV文件。PCM、8K采样、单声道，每秒8K字节

录音盒有2秒的录音缓冲区，所以最短的录音时间是2秒。

函数名称：int WINAPI SW_ StopFileRecord(int nIndex)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个设备

时，为0

函数返回： 0-正确返回 -1 错误。

功能描述： 停止文件录音。

说 明: 由于USB录音盒的可移动性和支持热插拔，这样在录音过程中若拔去USB录音盒，此时调用所有的函数会返回-1，报告错误状态，由于录音文件是WAV格式文件，需要正确的文件头才可以播放，所以，在这种情况下为防止数据丢失，应该调用SW_

StopFileRecord()函数，该函数将正确的文件信息保存到WAV文件中，数据就不会丢失。

。接收来电号码函数

函数名称：int WINAPI SW_ReceiveCID(int nIndex, char *lpBuf)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个

设备时，为0 精品

lpBuf 数据的存放地址

函数返回： 返回收到的来电号码的长度 0 – 没有收到来电号码 -1 - 错误

功能描述： 得到来电号码。

兼容FSK和DTMF两种制式，使用本函数，要求用户的电话在电信局开通了来电显示功能

号码对应关系：0-9对应字符’0’-‘9’

注意： 该函数有自动清除来电号码的功能，即：若第一次读到来电号码，下一次调用该函数时将自动把缓冲区清0。

。接收DTMF号码函数

函数名称：int WINAPI SW_ReceiveDTMF(int nIndex, char *lpBuf)

入口参数： nIndex USB电话录音盒的设备号(线路号)，系统连接一个

设备时，为0

lpBuf 数据的存放地址

函数返回： 返回收到的DTMF码的长度 0 – 没有收到DTMF码 -1 - 错误

功能描述： 得到DTMF码。包括呼出的电话号码和二次输入的DTMF号码

号码对应关系：0-9对应字符’0’-‘9’、’*’、’#’、’A’-’D’

注意： 该函数有自动清除DTMF缓冲区的功能，即：若第一次读到DTMF号码，下一次调用该函数时将自动把缓冲区清0。

编程建议

1．程序开始调用SW_Init()初始化

2．调用SW_GetCount()函数得到连接数，为0，没有录音盒连接。

3．在调用录音、DTMF、CID函数时，若返回-1，表示发生错误，录音盒具有

错误自动恢复功能，用户程序可继续执行；若多次返回错误，用户此时可

结合SW_GetCount()函数判断录音盒是否已被拔下。做相应处理。

4．退出，调用SW_Free()

精品

VC环境

Visual C++ 接口简介

用户可通过静态和动态方式实现对库的调用，具体使用方法可参看Visual C++ 的相应文档或参看示例程序。

SWIND.H内容如下：

bool WINAPI SW_Init();

bool WINAPI SW_Free();

void WINAPI SW_SetType(int DeviceType);

int WINAPI SW_GetCount();

int WINAPI SW_GetSN(int nIndex);

int WINAPI SW_CheckDisconnect(int nIndex);

int WINAPI SW_CheckRing(int nIndex);

int WINAPI SW_CheckOffHook(int nIndex);

int WINAPI SW_ReceiveDTMF(int nIndex, char *lpBuf);

int WINAPI SW_ReceiveCID(int nIndex, char *lpBuf);

int WINAPI SW_StartFileRecord(int nIndex, char *FileName , DWORD

FileLength );

int WINAPI SW_StopFileRecord(int nIndex );

long WINAPI SW_CheckFileRecordEnd(int nIndex);

Visual C++下的示范程序目录：

安装目录

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。

C++Builder环境

Borland C++ Builder接口简介 精品

由于是在VC下开发而成，LIB文件不能直接给BCB使用，所以用户需要使用程序从生成文件。

Borland C++ Builder中DLL的调用

在 Borland C++ Builder 中，要调用一个 DLL 函数，可使用动态方式和静态方式，具体使用方法可参看Borland C++ Builder的相应文档或参看示例程序。

SWIND.H内容如下：

bool WINAPI SW_Init();

bool WINAPI SW_Free();

void WINAPI SW_SetType(int DeviceType);

int WINAPI SW_GetCount();

int WINAPI SW_GetSN(int nIndex);

int WINAPI SW_CheckDisconnect(int nIndex);

int WINAPI SW_CheckRing(int nIndex);

int WINAPI SW_CheckOffHook(int nIndex);

int WINAPI SW_ReceiveDTMF(int nIndex, LPBYTE lpBuf);

int WINAPI SW_ReceiveCID(int nIndex, LPBYTE lpBuf);

int WINAPI SW_StartFileRecord(int nIndex, LPBYTE FileName , DWORD

FileLength );

int WINAPI SW_StopFileRecord(int nIndex );

long WINAPI SW_CheckFileRecordEnd(int nIndex);

Borland C++ Builder下的示范程序目录：

安装目录C++

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。

精品

VB环境

VB接口简介

在 Visual Basic 6.0 中， 对动态库的调用是通过 来声明的，请参见。

VB6.0对动态库的调用

在VB6.0中，需要首先对DLL中的函数进行声明，然后才能对该函数进行调用。关于如何声明DLL中的函数，请参考VB中的HELP文件"DECLARE STATEMENT"。

下面，通过举例来说明。当 中有新的函数未能包含在VB声明文件中时，你可以参考该函数在C语言中的声明，自己来声明VB下的函数调用。

例如：

在SWIND.H中的函数

INT WINAPI SW_CHECKOFFHOOK(INT NINDEX)

在中声明为

DECLARE FUNCTION SW_CHECKOFFHOOK LIB "" (BYVAL NINDEX AS

INTEGER) AS INTEGER

要注意的一点是，所有参数和返回值的字节长度要相等。

VB编程的注意事项

由于VB是解释型的编程语言，它在设计时有一些不同的出发点，因此，在使用VB调用DLL时，有一些事项应引起注意。

如果在C语言中某函数的参数为字符串，并且在函数调用完毕后，有内容通过该参数返回，当VB使用该函数时，带入的变量必须是已经分配空间的。

例如：

Dim MsgStr As String * 200

中的声明如下:

Declare Function SW_Init Lib "" () As Integer 精品

Declare Function SW_Free Lib "" () As Integer

Declare Function SW_SetType Lib "" (ByVal DeviceType As Integer)

As Integer

Declare Function SW_GetCount Lib "" () As Integer

Declare Function SW_GetSN Lib "" (ByVal nIndex As Integer) As

Integer

Declare Function SW_CheckOffHook Lib "" (ByVal nIndex As

Integer) As Integer

Declare Function SW_CheckDisconnect Lib "" (ByVal nIndex As

Integer) As Integer

Declare Function SW_CheckRing Lib "" (ByVal nIndex As Integer)

As Integer

Declare Function SW_ReceiveDTMF Lib "" (ByVal nIndex As Integer,

ByVal lpBuf As String) As Integer

Declare Function SW_ReceiveCID Lib "" (ByVal nIndex As Integer,

ByVal lpBuf As String) As Integer

Declare Function SW_StartFileRecord Lib "" (ByVal nIndex As

Integer, ByVal FileName As String, ByVal FileLength As Long) As Integer

Declare Function SW_StopFileRecord Lib "" (ByVal nIndex As

Integer) As Integer

Declare Function SW_CheckFileRecordEnd Lib "" (ByVal nIndex As

Integer) As Long

VB下的示范程序目录：

安装目录

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。 精品

DELPHI环境

Delphi对动态库的调用

在Delphi中需要首先对DLL中的函数进行声明，然后才能对该函数进行调用。关于如何声明DLL中的函数，请参考Delphi中的HELP文件"external

declarations"。

你可以参考该函数在C语言中的声明，自己来声明Delphi下的函数调用。

例如：

在SWIND.h中的函数

int WINAPI SW_CheckOffHook(int nIndex);

在Delphi中：

function SW_CheckOffHook (nIndex: DWORD) : INTEGER; stdcall;

external '';

注意：声明最后要加stdcall; external '';

在C语言中的char *，要声明为 pchar

中的声明如下:

function SW_Init():Integer; stdcall; far external '';

function SW_Free():Integer; stdcall; far external '';

function SW_SetType(DeviceType:DWORD):Integer; stdcall; far external

'';

function SW_GetCount():Integer; stdcall; far external '';

function SW_GetSN(nIndex:DWORD):Integer; stdcall; far external

'';

function SW_CheckOffHook(nIndex:DWORD):Integer; stdcall; far

external '';

function SW_CheckDisconnect(nIndex:DWORD):Integer; stdcall; far

external '';

function SW_CheckRing(nIndex:DWORD):Integer; stdcall; far external 精品

'';

function SW_ReceiveDTMF(nIndex: DWORD;lpBuf: PCHAR):Integer; stdcall;

far external '';

function SW_ReceiveCID(nIndex: DWORD;lpBuf: PCHAR):Integer; stdcall;

far external '';

function SW_StartFileRecord(nIndex: DWORD;FileName: PCHAR;FileLength:

WORD):Integer; stdcall; far external '';

function SW_StopFileRecord(nIndex:DWORD):Integer; stdcall; far

external '';

function SW_CheckFileRecordEnd(nIndex:DWORD):Integer; stdcall; far

external '';

DelPhi下的示范程序目录：

安装目录

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。

PB环境

PB7接口简介

在PowerBuilder 中，对动态库的调用是通过在"Decalre"菜单中的"Global External Function"来声明的。

中有新的函数未能包含在声明中时，你可以参考该函数在C语言中的声明，自己来声明PB下的函数调用。

例如：

在SWIND.h中的函数

int WINAPI SW_CheckOffHook(int nIndex);

在Power Builder 中：

Function Integer SW_CheckOffHook(Integer nIndex) Library "" 精品

用户可将以下的声明包含在自己的文件中，实现对动态库的调用

Function Integer SW_Init() Library ""

Function Integer SW_Free() Library ""

Function Integer SW_SetType(Integer DeviceType) Library ""

Function Integer SW_GetCount() Library ""

Function Integer SW_GetSN(Integer nIndex) Library ""

Function Integer SW_CheckOffHook(Integer nIndex) Library ""

Function Integer SW_CheckDisconnect(Integer nIndex) Library

""

Function Integer SW_CheckRing(Integer nIndex) Library ""

Function String SW_GetStrDTMF(Integer nIndex) Library ""

Function String SW_GetStrCID(Integer nIndex) Library ""

SW_StartFileRecord(Integer nIndex,String FileName,long FileLength)

Library ""

Function Integer SW_StopFileRecord(Integer nIndex) Library ""

Function Long SW_CheckFileRecordEnd(Integer nIndex) Library

""

注意：在PB和VFP环境中，SW_ReceiveDTMF()和SW_ReceiveCID()函数被SW_GetStrDTMF() 和SW_GetStrCID()函数代替。具体用法参见示例程序

PB下的示范程序目录：

文件路径安装目录

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。

精品

VFP环境

VFP接口简介

在Visual FoxPro 中， 对动态库的调用是通过

来声明的,请参见。

VFP对动态库的调用

在 Visual FoxPro 中，要调用一个 DLL 函数，可首先使用 DECLARE

命令声明 DLL 函数，然后像调用其它 Visual FoxPro 函数一样调用 DLL

函数。你可以参考该函数在C语言中的声明，自己来声明VFP下的函数调用。

例如：

在SWIND.H中的函数

bool WINAPI SW_Init ( )

在 Visual FoxPro 中：

Declare integer SW_Init in

在退出 Visual FoxPro 之前，所链接的 DLL 函数一直保持有效，因此，在每个工作期中只需声明一次。

在声明一个 DLL 函数时，必须指定参数的数目和类型。默认情况下，数据按照值来传递，但也可以在参数前面添加符号(@) 来强制参数按引用传递。

用户可将以下的声明加入自己的PRG文件中:

Declare integer SW_Init in

Declare integer SW_Free in in

Declare integer SW_SetType in integer DeviceType

Declare integer SW_GetCount in in

Declare integer SW_GetSN in integer nIndex

Declare integer SW_CheckOffHook in integer nIndex

Declare integer SW_CheckDisconnect in integer nIndex

Declare integer SW_CheckRing in integer nIndex

Declare string SW_GetStrDTMF in integer nIndex 精品

Declare integer SW_GetStrCID in integer nIndex

Declare integer SW_StartFileRecord in integer nIndex, string FileName,

long FileLength

Declare integer SW_StopFileRecord in integer nIndex

Declare long SW_CheckFileRecordEnd in integer nIndex

注意：在VFP和PBP环境中，SW_ReceiveDTMF()和SW_ReceiveCID()函数被SW_GetStrDTMF() 和SW_GetStrCID()函数代替。具体用法参见示例程序

VFP下的示范程序目录：

安装目录

该程序实现摘挂机检测、录放音、接收来电号码、接收DTMF号码。

其他编程语言

在98/2000/XP的32位编程环境中，许多编程语言都可以用各种方式来调用DLL动态库。这样，也就可以通过对动态库的调用来控制USB电话录音盒。

由于各种编程语言的方法不尽相同，本说明书无法一一描述。请用户仔细阅读你所用的编程语言的说明。 精品