USB盒动态库开发文档.doc

USB盒动态库开发文档
概述
USB盒有以下几种类型：Fi3001B（1路USB录音盒）、Fi3002B（2路USB录音盒）、Fi3101A（1路USB语音盒,带耳麦和电话机）、Fi3102A（2路USB 语音盒），其中Fi31拔一下，重新运行软件，看是否正常。
出现的原因：Windows应用程序和设备通信出现异常。
。
，一般要求USB线插到电脑后端。
，退出软件，硬件重新插拔一下，重新运行软件，还是出现这个设备错误事件，那USB设备有问题了。
UBOX_EVENT_LINE_RINGING 振铃
功 能：通知应用程序线路振铃
参 数：uboxHnd: 设备句柄
eventID: UBOX_EVENT_LINE_RINGING
param1、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_UP
UBOX_EVENT_LINE_HOOK_OFF 事件 摘机
功 能：通知应用程序线路摘机。
参 数：uboxHnd 是设备句柄
eventID: UBOX_EVENT_LINE_HOOK_OFF
param1 = 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_CANCEL
UBOX_EVENT_LINE_VOLTAGE 线路电压事件
功 能：报告线路当前电压。
参 数：uboxHnd: 设备句柄
eventID: UBOX_EVENT_LINE_VOLTAGE
param1 线路当前电压
说 明: Fi3001有这个功能,调用ubox_start_read_line_voltage（）后，才会触发本事件，触发间隔是200ms ,只有调用ubox_stop_read_line_voltage（）才会停止触发这个事件。
Fi3002B ，调用一次ubox_start_read_line_voltage（）产生一次线路电压事件。对于Fi3002B ubox_start_read_line_voltage（）返回值也是线路电压，线路电压可以不用从这个事件获取，可以不用调用ubox_stop_read_line_voltage()函数。
UBOX_EVENT_STREAM_VOICE事件 流式录音事件
功 能：通知应用程序流式录音数据包。
参 数：uboxHnd: 是设备句柄
eventID: UB