USB盒动态库开发文档

(一) 概述USB盒有以下几种类型：Fi3001B（1路USB录音盒）、Fi3002B（2路USB录音盒）、Fi3101A（1路USB语音盒,带耳麦和电话机）、Fi3102A（2路USB 语音盒），其中Fi3101, Fi3002和Fi3102在window 2000不能工作。如果想要Fi3001在windows 2000工作，必须要换动态库phonic_ubox.dll，用目录fi3001_lib下的phonic_ubox.dll替换通用的动态库。所有USB盒采用统一的编程接口Phonic_ubox.dll。Phonic_ubox.dll通过回调函数通知发生的事件，其函数说明和事件的定义参考头文件phonic_ubox.h。该接口支持下面几种类型的产品，统一用此接口。Fi3001B 1路USB录音盒 (phonic_ubox.dll, phonic_utool.dll)Fi3101A 带耳麦的USB语音盒（1外1内）(phonic_ubox.dll,phonic_utoolI.dll)Fi3002B 2路USB录音盒 (phonic_ubox.dll, phonic_utoolII.dll)Fi3102A 2路USB 外线 (phonic_ubox.dll, phonic_utoolII.dll) 上面括号内表示：应用程序必须依赖的库的文件。 Fi3002B有两个版本，版本号为6.060支持测量电压功能，低于该版本的硬件不支持测量线路电压功能。编程时第一个要调用的函数是ubox_open(UBoxEventNotifyProc proc, UBOX_WORK_MODE mode)，用于设置事件回调函数，并启动USB盒。事件回调函数原形如下：typedef void ( CALLBACK* UBoxEventNotifyProc )( UBOX_HANDLE uboxHnd 设备句柄，一个合法的设备句柄是不等于-1的整数，这个值对于不同的PC机的USB端口的值是不同的，多个USB设备通过它来区别, int eventID 事件，参考UBOX_EVENT的定义, unsigned long param1 下面几个参数不同的事件，其含义不同, unsigned long param2 事件参数2, unsigned long param3 事件参数3, unsigned long param4 事件参数4);其简单开发流程：1. 先调用ubox_open函数；2. 如果USB录音盒设备已插入，会有设备插入事件UBOX_EVENT_DEVICE_PLUG_IN通知上层程序；3. 电话振铃, 主叫号码,摘机，挂机、按键和都会用事件通知上层程序；4. 一般在摘机事件触发时调用ubox_record_file开始录音，在挂机事件触发时调用ubox_stop_record停止录音；5. 拨号调用ubox_send_dtmf，号码发送完毕，应用程序会收到UBOX_EVENT_CALLOUTFINISH事件。由于有彩铃，无法正确判断对方是否摘机，所以底层没有做检测对方摘机功能。但是具有检测对方挂机忙音功能，当底层检测到挂机忙音，会送UBOX_EVENT_DEVICE_BUSY_TONE事件给应用程序。6. 程序退出时要调用用ubox_close（）关闭设备。 请看“usb盒常见开发问题.doc”文档(二) UBOX_EVENT 事件 UBOX_EVENT_DEVICE_PLUG_IN 设备插入功 能：通知应用程序检测到USB设备插入参 数：UBOX_HANDLE uboxHnd 是USB设备句柄 eventID： UBOX_EVENT_DEVICE_PLUG_IN说 明：USB设备句柄用于标识USB线路。不同USB盒的句柄并不是连续的，但对于同一个2路的USB盒，其线路1和线路2的句柄值是相邻的。有设备句柄参数的函数必须要在通道收到UBOX_EVENT_DEVICE_PLUG_IN事件后才能调用。UBOX_EVENT_DEVICE_PLUG_OUT 设备拨出功 能：通知应用程序设备拨出。参 数：uboxHnd 是设备句柄 eventID： UBOX_EVENT_DEVICE_PLUG_OUTUBOX_EVENT_ALARM 报警功 能：设备报警，软件要重新启动，否则不能录音和放音。Param为7，不要做任何特殊处理。参 数：uboxHnd: 设备句柄 eventID: UBOX_EVENT_ALARMparam1: 工作异常的原因,有四种情况: 1 -未能找到ubox 的MIC 设备 2 -未能打开ubox 的 MIC 设备 3 -未能打开ubox 的放音设备 4 -设备故障,设备工作不正常，软件退出，检查设备驱动程序是否安装好。 UBOX_WIN7_AUDIO_EXCEPTION = 5, /Vista 和win7 audio 设备故障，需要重新调用ubox_close,然后调用ubox_open UBOX_ALARM_RESET_AUDIO_FAILD =6, /复位 audio device失败,不能录音，也收不到来电号码和按键的。UBOX_ALARM_RESET_AUDIO_SUCCESS =7, /复位 audio device 成功,只是提示，不要做任何特殊处理 出现的原因可能如下：1. 和电脑的USB接触有问题。2. USB audio device驱动程序没有安装好（操作系统自动安装），正在安装的过程中，运行了软件。3. 操作系统不是完整版本，缺少USB audio devcie驱动，安装驱动精灵试一下，看是否能修复驱动程序，如果修复不了，只能安装完整版本操作系统。4. 供电和信号差，一般要求USB线插到电脑后端。5. windows audio 服务被禁用了，将该服务设置为自动和启动，重启电脑。6. USB audio device在声卡属性中被禁用，将禁用取消。7. 运行了多个USB程序打开USB设备，也会导致这种情况。8. 操作系统出现问题，需要操作系统重启。UBOX_EVENT_DEVICE_ERROR 设备错误功 能：通知应用程序设备错误。参 数：uboxHnd: 设备句柄 eventID: UBOX_EVENT_DEVICE_ERROR设备错误,会导致接收不到主叫号码。处理方法：退出软件，硬件重新插拔一下，重新运行软件，看是否正常。 出现的原因：Windows应用程序和设备通信出现异常。1.和电脑的USB接触有问题。2.供电和信号差，一般要求USB线插到电脑后端。3.如果换了多个USB口或者换了一台电脑，退出软件，硬件重新插拔一下，重新运行软件，还是出现这个设备错误事件，那USB设备有问题了。UBOX_EVENT_LINE_RINGING 振铃功 能：通知应用程序线路振铃参 数：uboxHnd: 设备句柄eventID: UBOX_EVENT_LINE_RINGINGparam1、param2、param3、param4未使用UBOX_EVENT_LINE_RING_STOP 停振功 能：通知应用程序线路停振。 参 数： uboxHnd: 设备句柄 eventID: UBOX_EVENT_LINE_RING_STOP说了 明： 电话机振铃一般是振1秒，停振4秒的一个周期。UBOX_EVENT_LINE_HOOK_UP 事件 挂机功 能：通知应用程序线路挂机。 参 数：uboxHnd: 是设备句柄 eventID: UBOX_EVENT_LINE_HOOK_UPUBOX_EVENT_LINE_HOOK_OFF 事件 摘机功 能：通知应用程序线路摘机。参 数：uboxHnd 是设备句柄 eventID: UBOX_EVENT_LINE_HOOK_OFFparam1 = 0,表示电话机摘机 Param1 6，表示反向摘机，指软件摘机 Param1 = 7, 表示正向摘机，指软件摘机软摘机总会是后面两者之一。UBOX_EVENT_LINE_HANG 悬空功 能：通知应用程序线路悬空。参 数：uboxHnd: 是设备句柄 eventID: UBOX_EVENT_LINE_HANG说 明: 只有Fi3001才有这个功能，如果电话线被拨掉，先触发摘机事件 ，经过20-30秒后再触发悬空事件。UBOX_EVENT_LINE_CANCEL 振铃取消功 能：通知应用程序振铃取消，当末次振铃停止超过6秒，则触发此事件。 未接电话可通过它判断。参 数： uboxHnd 是设备句柄 eventID UBOX_EVENT_LINE_CANCELUBOX_EVENT_LINE_VOLTAGE 线路电压事件功 能：报告线路当前电压。参 数：uboxHnd: 设备句柄 eventID: UBOX_EVENT_LINE_VOLTAGE param1 线路当前电压说 明: Fi3001有这个功能,调用ubox_start_read_line_voltage（）后，才会触发本事件，触发间隔是200ms ,只有调用ubox_stop_read_line_voltage（）才会停止触发这个事件。 Fi3002B V6.060版本也支持量电压功能，调用一次ubox_start_read_line_voltage（）产生一次线路电压事件。对于Fi3002B V6.060 ubox_start_read_line_voltage（）返回值也是线路电压，线路电压可以不用从这个事件获取，可以不用调用ubox_stop_read_line_voltage()函数。UBOX_EVENT_STREAM_VOICE事件 流式录音事件功 能：通知应用程序流式录音数据包。参 数：uboxHnd: 是设备句柄 eventID: UBOX_EVENT_STREAM_VOICE param1: 录音数据地址，需要转换，unsigned char* pvoice= (unsigned char*)param1param2: 是录音数据长度说 明: 每隔20ms会有一个录音数据，可用于网络录音和录音监听。要停止触发该事件必须调用ubox_stop_record UBOX_EVENT_CALLER_ID事件 来电号码功 能：通知应用程序来电号码。参 数：uboxHnd: 是设备句柄 eventID: UBOX_EVENT_CALLER_IDparam1 是号码地址 param2 是时间地址 param3 是姓名地址 需要类型转换 char* pszcallId =(char*)param1, char* pszcalltime=(char*)param2, char* pszcallname=(char*) param3 UBOX_EVENT_DTMF_DOWN事件 用户按键功 能：通知应用程序用户按键。参 数：uboxHnd 是设备句柄 eventID：UBOX_EVENT_DTMF_DOWN param1 是按键键值，需要类型转换 char dtmf = (char) param1。UBOX_EVENT_DTMF_UP 用户按键释放功 能：通知应用程序用户按键释放，该事件暂时不用参 数： uboxHnd 是设备句柄 eventID UBOX_EVENT_DTMF_DOWN param1 是按键键值，需要类型转换 char dtmf = (char) param1。 UBOX_EVENT_DEVICE_PLAY_END 放音结束功 能：通知应用程序通道放音结束。参 数：uboxHnd 设备句柄eventID UBOX_EVENT_DEVICE_PLAY_ENDUBOX_EVENT_DEVICE_PLAY_ERROR 放音错误功 能：通知应用程序通道放音错误。参 数：uboxHnd 是设备句柄 eventID UBOX_EVENT_DEVICE_PLAY_ERRORUBOX_EVENT_DEVICE_BUSY_TONE 检测到忙音功 能：通知应用程序通道检测到忙音，表示对方已挂机。参 数：UBOX_HANDLE uboxHnd 是设备句柄 eventID UBOX_EVENT_DEVICE_BUSY_TONEUBOX_EVENT_CALLOUTFINISH 拨号完成事件功 能：通知应用程序通道软件拨号完成，但并不表示拨号成功。参 数：uboxHnd 是设备句柄 eventID UBOX_EVENT_CALLOUTFINISHUBOX_EVENT_POLARITY 极性检测事件功 能：通知应用程序通知应用程序检测到极性反转。参 数： uboxHnd 是设备句柄 eventID UBOX_EVENT_POLARITY param1： 正极，反极，其它参数不使用说 明: 极性检测用于外线呼出后对方摘机的判断以及通话过程中对方挂机的判断。极性反转的功能必须向电信部门另外申请。(三) 函数错误返回值 UBOX_ERR_SUCCESS = 0, 操作成功UBOX_ERR_SYSTEM = -1, 系统错误，调用操作系统(windows)的方法时出现错误，错误的详细信息可查看日志文件： UBOX_ERR_DEVICE_NOT_FOUND= -2, 没有这个设备，可能设备已经被拔出UBOX_ERR_INVALID_HANDLE= -3, 不合法的UBOX_HANDLEUBOX_ERR_INVALID_PARAMETER= -4, 不合法的输入参数UBOX_ERR_EXCEPTION= -5, 发生异常UBOX_ERR_INVALID_WORK_MODE= -6, 错误的工作模式UBOX_ERR_UBOX_NOT_OPEN= -7, ubox设备尚未打开UBOX_ERR_CANNOT_CREATE_DIR= -10, 未能创建目录，当指定录音时，如果文件名包含目录路径，则ubox将试图建立相应的目录树。UBOX_ERR_CANNOT_CREATE_FILE= -11, 未能创建录音文件UBOX_ERR_INVALID_VOICE_CODER= -12, 不支持的语音编码UBOX_ERR_DEVICE_BUSY= -13, 设备忙，当设备已经在录音的时候再次指示其同类型(文件与文件、STREAM与STREAM)的录音，就会返回此错误码(四) 函数说明 int WINAPIubox_open(UBoxEventNotifyProc proc, UBOX_WORK_MODE mode)功 能：设置事件通知回调函数和工作模式参 数：proc 回调函数 ,原型如下:typedef void ( CALLBACK* UBoxEventNotifyProc )( UBOX_HANDLE uboxHnd 设备句柄, int eventID 事件，参考UBOX_EVENT的定义, unsigned long param1 下面几个参数不同的事件，其含义不同, unsigned long param2 事件参数2, unsigned long param3 事件参数3, unsigned long param4 事件参数4);mode USB盒的工作模式，通常的方式是录音方式,有以下模式：0, 录音模式，通常使用的模式, 诊断模式，用于捕获线路信息，供信号分析之用，支持的语音编码方式是CODER_PCM 配置模式， UBOX_MODE_RECORD = 0 , 录音模式，通常使用的模式UBOX_MODE_DIAG = 1, 诊断模式，用于捕获线路信息，供信号分析之用，支持的语音编码方式是CODER_PCM UBOX_MODE_CONFIG = 2, 配置模式返 回: 0成功，错误参照“函数错误返回值 ”说 明:这个函数成功调用并不表示USB设备打开成功,事件UBOX_EVENT_DEVICE_PLUG_IN通知上层程序，表示设备打开成功。收到UBOX_EVENT_ALARM和UBOX_EVENT_DEVICE_ERROR事件，上层应用程序要对它们处理，否则不能正确工作。只有Fi3001配置模式才有用，有几个函数要在配置模式下使用。其它类型的产品配置模式无用。下面的几个函数必须配置模式下使用,下面列出的函数如果没有特殊说明都可以在录音模式和诊断模式使用。 void WINAPIubox_close(void)功 能：关闭设备说 明: 最后程序退出，必须调用这个函数，否则会出现异常int WINAPI ubox_get_device_versionnum(UBOX_HANDLE uboxHnd ,float &version_num)功 能：获取硬件的版本号，返 回: version_num由整数部分和1位小数部分组成， 整数部分是主版本号，小数部分是次版本号参 数: uboxHnd 设备句柄version_num获取的版本号int WINAPI ubox_get_product_ID(UBOX_HANDLE uboxHnd) 获取产品设备号功 能：获取产品设备号参 数：uboxHnd是设备句柄返 回: 对应的产品设备号： 1 - FI3102A 2 - FI3002B3 - FI3001B 4 - FI3101AInt WINAPI ubox_get_product_name(UBOX_HANDLE uboxHnd,char* product_name) 获取产品设备名字功 能：获取产品设备名字，该函数和ubox_get_product_ID功能一样，只是产品类型表示是用 字符串表示。参 数：uboxHnd 设备句柄product_name 保存产品名字的地址,指向字符空间不要小于7个字节。返 回 值: 对于产品名字的长度。产品名字是下面的一种： “FI3102A” 两路外线“FI3002B” 两路高阻录音“FI3001B” 1路高阻录音“FI3101A” 带耳麦的语音盒int WINAPI ubox_get_usernum(UBOX_HANDLE uboxHnd,unsigned char* user_num,int len) 功 能：读取用户号参 数: uboxHnd 设备句柄user_num 用于保存用户号的buffer, 用户号的长度是16个字节,前8个字节为用户编号,后8个字节为出厂日期,按照:月-日-年格式显示len user_num的长度,不能低于16返 回: 成功返回用户号的长度，错误返回为非0说 明: 卖给同一个客户的所有的USB盒的用户号是相同的,一般USB盒出厂时,不写用户号,如果需要用户号请联系我公司，int WINAPI ubox_get_work_mode( void )功 能：获取当前工作模式返 回：USB盒的工作模式,有以下模式： UBOX_MODE_RECORD = 0 , 录音模式，通常使用的模式UBOX_MODE_DIAG = 1, 诊断模式，用于捕获线路信息，供信号分析之用，支持的语音编码方式是CODER_PCM UBOX_MODE_CONFIG = 2, 配置模式intWINAPIubox_check_coder( int coder )功 能：检查指定的语音编码是否合法参 数：coder语音编码，支持以下编码格式：CODER_ALAW= 0,CODER_PCM = 1,CODER_G729= 3,CODER_SPEEX = 20, 这是8倍压缩，安装speexw.exe的插件，播放器就可以播放了CODER_MP3 = 38,CODER_ULAW= 100,返 回：0 -语音编码是合法的， UBOX_ERR_INVALID_VOICE_CODER 语音编码不合法intWINAPIubox_record_file(UBOX_HANDLE uboxHnd, const char* filename, int coder ) 录音功能：录音到文件中参数：uboxHnd 设备句柄filename 录音文件名,如果编码格式选择CODER_MP3,文件名后缀为.mp3,其它格式推荐使用.wav后缀. Coder 语音编码，支持以下格式：CODER_ALAW= 0,CODER_PCM = 1,CODER_G729= 3,CODER_SPEEX = 20, 这是8倍压缩，安装speexw.exe的插件，播放器就可以播放了CODER_MP3 = 38,CODER_ULAW= 100,一般推荐用CODER_ALAW, CODER_MP3和CODER_SPEEX编码。函数返回：0成功 0 悬空门限值 0 摘机门限值 0失败，说 明：产品产品Fi3001B和 Fi3002B V6.060版本调用这个函数才有意义。intWINAPIubox_set_hookoff_threshold(UBOX_HANDLE uboxHnd, int threshold ) 功 能：设置摘机门限值。参 数： uboxHnd 设备句柄threshold的值是摘机电压和挂机电压的之和的一半，摘机电压和挂机电压测量调用ubox_start_read_line_voltage，对于Fi3001B摘机状态是通过电压判断的。产品Fi3001B和 Fi3002B V6.060版本 调用这个函数才有意义。说 明: Fi3001和 Fi3002B V6.060版本是通过压控方式检测电话状态,通常情况下,挂机时直流电压为48V左右,摘机时直流电压会降到6V左右。USB录音盒设置默认摘机门限值为18V, 当线路电压大于18V,软件判断为挂机,小于18V软件判断为摘机。由于电话线的所处的环境不同,线路直流电压值不同,可能摘机后,线路电压依然要大于摘机门限值,这样软件不能正确检测到电话状态,需要重新设置摘机门限值。intWINAPIubox_start_read_line_voltage(UBOX_HANDLE uboxHnd ) 功 能：开始检测线路电压参 数： uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”说 明: 调用这个函数后，在Fi3001B中，调用该函数， 会每隔200ms不停触发UBOX_EVENT_LINE_VOLTAGE事件,报告当前线路电压值。要停止测量线路电压必须要调用ubox_stop_read_line_voltage函数。除了产品Fi3001B支持该功能，Fi3002B V6.060版本也支持量电压功能，调用一次ubox_start_read_line_voltage（）产生一次线路电压事件。对于Fi3002B V6.060 ubox_start_read_line_voltage（）返回值也是线路电压，线路电压可以不用从这个事件获取，可以不用调用ubox_stop_read_line_voltage()函数。intWINAPIubox_stop_read_line_voltage(UBOX_HANDLE uboxHnd ) 功 能：结束检测线路电压参 数： uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”说 明: 调用这个函数后，会停止触发UBOX_EVENT_LINE_VOLTAGE事件 产品Fi3001B调用这个函数才有意义。int WINAPI ubox_send_dtmf(UBOX_HANDLE uboxHnd ,const char* dmftfstring)功 能：发送号码（DTMF） 参 数: uboxHnd 设备句柄Dmftfstring 号码串返 回: 0成功，错误参照“函数错误返回值 ”说 明: 对于Fi3101A，电话机摘机，软件拨号，要调用软摘机函数，然后调用本函数，拨号声音会到耳麦里输出，号码拨完后，底层会自动软挂机，声音会切换到电话机里，如果电话机摘机，声音自动切换到电话机里，底层会自动软挂机，耳机无声音 。Fi3001B和Fi3002B，必须要先手动摘机，才可以拨号。对于有软摘机功能的产品(Fi3101A和Fi3102A)，直接软件拨号，有可能拨号不成功，拨得太快了，交换机需要时间检测摘机，因此处理方法上层程序需要先软摘机后，延时1-2S钟，然后再调用ubox_send_dtmf函数。int WINAPI ubox_play_file(UBOX_HANDLE uboxHnd ,const char* filename)功 能： 播放语音文件参 数: uboxHnd 设备句柄filename是语音文件。返 回: 0成功，错误参照“函数错误返回值 ”说 明： 放音格式为： A-law,u-law, 8k * 16 位 pcm文件 对于录音盒必须要电话机摘机，才可以放音。 语音盒要软摘机，才可以放音。 放音文件的格式，用wav文件，wav文件的格式有很多种。我们支持下面一些。a-Law和u-law: 采样大小是8位， 单声道， 8Khz采样。线性PCM： 采样大小是16位， 单声道， 8Khz采样。 鼠标右键点击文件，选择属性，会打开一个窗口，在窗口点击“摘要”，就能看到文件音频属性。int WINAPI ubox_stop_play(UBOX_HANDLE uboxHnd)功 能：在设备打开后，停止播放。参 数: uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”int WINAPI ubox_play_pause(UBOX_HANDLE uboxHnd)功 能：暂停播放，再调用一次，又继续播放，参 数: uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”intWINAPIubox_set_volume(UBOX_HANDLE uboxHnd,int volume ) 设置MIC音量功 能：设置MIC音量，设置音量为0db就可以了参 数: uboxHnd 设备句柄Volume 取值范围0-19返 回: 0成功，错误参照“函数错误返回值 ”int WINAPI ubox_set_Speakervolume (long uboxHandle，short volume) 设置放音音量功 能：设置放音音量 参 数: uboxHnd 设备句柄Volume 为0-20，系统默认值是10返 回: 0成功，错误参照“函数错误返回值 ”int WINAPI ubox_close_agc(UBOX_HANDLE uboxHnd,bool bclose)功 能：打开和关闭AGC。参 数: uboxHnd 设备句柄bclose 为true,关闭agc；为false，打开agc,默认情况下是打开agc。返 回: 0成功，错误参照“函数错误返回值 ”int WINAPI ubox_read_eeprom(UBOX_HANDLE uboxHnd,unsigned char addr,unsigned char* outdata,int len)功 能：读取USB录音盒中eeprom内的数据。参 数: uboxHnd 设备句柄Addr 要读取的数据的起始地址，范围为0x00-0x07,Outdata 存放读取数据的bufferLen 读取长度用 法： 假如uboxHnd1，addr=0x0,unsigned char readdata8，ubox_read_eeprom (1,0x00,&readata0,8),调用成功后，读取的数据在readdata中返 回: 0成功，错误参照“函数错误返回值 ”说 明：Fi3001B使用该函数必须要在配置模式下才能使用。int WINAPI ubox_write_eeprom(UBOX_HANDLE uboxHnd,unsigned char addr,unsigned char* indata,int len)功 能：往USB录音盒中的eeprom写入数据。参 数: uboxHnd 设备句柄Addr 开始写入的起始地址，范围为0x00-0x07,Indata 存放要写入的数据的buffer Len 写入的数据的长度返 回: 0成功，错误参照“函数错误返回值 ”用 法: 假如uboxHnd1，addr=0x00,unsigned char writedata8 = 0x01,0x20,0x30,0x31,0x32,0x33,0x40,0x70 ubox_write_eeprom(1,0x0,&writedata0,8),可以在同一个地址区域调用ubox_read_eeprom验证，读取的数据和写入数据是否相等int WINAPI ubox_read_eepromEx(UBOX_HANDLE uboxHnd,unsigned char addr,unsigned char* outdata,int len)功 能：读取USB录音盒中eeprom内的数据。参 数: uboxHnd 设备句柄Addr 要读取的数据的起始地址，范围为0x00-0x07,Outdata 存放读取数据的bufferLen 读取长度用 法： 假如uboxHnd1，addr=0x0,unsigned char readdata8，ubox_read_eeprom (1,0x00,&readata0,8),调用成功后，读取的数据在readdata中返 回: 0成功，错误参照“函数错误返回值 ”说 明： 对于Fi3001B，调用ubox_write_eeprom写成功后，读取其正确值，必须在软件重新启动后（关闭后，再打开），调用ubox_read_eepromEx才能正确读取上次修改的值。而其它产品调用ReadEepromEx和ReadEeprom功能是一样的。int WINAPI ubox_soft_hook_off(UBOX_HANDLE uboxHnd)功 能：软件摘机参 数: uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”说 明：Fi3101A 和Fi3102A才具有该功能。int WINAPI ubox_soft_hook_on(UBOX_HANDLE uboxHnd)功 能： 软件挂机参 数: uboxHnd 设备句柄返 回: 0成功，错误参照“函数错误返回值 ”说 明： Fi3101A 和Fi3102A才具有该功能。调用了ubox_soft_hook_off，才能挂断电话线路的，在振铃时，为了不接本电话，直接调用ubox_soft_hook_on是无效的，模拟线路没有拒接功能的。int WINAPI ubox_set_busy_tone(UBOX_HANDLE uboxHnd,const tagBusyInfo busyinfo)功 能： 设置忙音参数。参 数: uboxHnd 设备句柄Busyinfo 用于设置忙音参数的数据结构。struct tagBusyInfolong busy_dual_frequency; 是否是双音频，默认为0 long busy_frequency0; 忙音频率0，默认450HZ long busy_frequency1; 忙音频率1，默认420HZ long busy_on; 忙音周期的持续时间，默认为35表示350ms long busy_off; 忙音周期的断续时间，默认为35表示350ms long busy_on_off_error; 忙音周期的持续时间和断续时间的误差，默认为5表示50ms long busy_enery_gate; 忙音的能量,默认为12db.long busy_period_count; 忙音判断的周期数,默认为3,表示连续检测到三个周期的忙音才报告有忙音UBOX_EVENT_DEVICE_BUSY_TONE事件.;返 回: 0成功，错误参照“函数错误返回值 ”说 明： Fi3101A 和Fi3102A才具有该功能。int WINAPI ubox_set_message_param(UBOX_HANDLE uboxHnd,bool bset) 功 能：设置留言模式参数，参 数: uboxHnd 设备句柄 Bset true 打开留言参数，false 关闭留言参数说 明: 设置留言模式下才需要打开留言参数。要退出留言模式，必须关闭留言参数，否则麦克风不能用 Fi3101A才具有该功能。