子佩CC301二次开发接口文档

1、CC301开发接口文档文件名称CC301 API开发接口文档起草人Juju.chen文档的版本。2.5起草日期2009-09-01购买产品qqQQQQ更新日期2013-11-21网站手机技术支持方式1前言1.1制作此文件的目的如何通过API控制CC301，将说明第三方软件可以使用CC301 (例如，CRM系统、办公室软件等)无缝地连接。建议您从WORD菜单中选择“显示”。 要浏览“文档结构图”，请选择“文档结构图”1.2共同的说明l以下提到的“PSTN”是连接公共电话交换网，即机器的线路口的线路。在下文中提到的电话机/电话

2、机是连接到装置的手机端口的装置(例如普通模拟电话机/模拟开关)。在下文中提及的分机也是连接至phone的设备(例如正常模拟电话机/模拟开关)。以下提到的PC是继CC301设备之后的PC。l以下所述的参数类型BRIINT64 -表示带符号的64位(8字节)BRIINT32 -表示带符号的32位(4字节)BRIUINT32 -表示无符号32位(4字节)BRIINT16 -表示带符号的16位(2字节)BRIUINT16 -表示有符号的16位(2字节)BRIBYTE8 -表示无符号8位(1字节)BRICHAR8 -表示带符号的8位(1字节)BRIPCHAR8 -表示字符串指针(ANSI )BRIPSH

3、ORT16-表示字符串指针(UNICODE )l以下提到的in表示此参数是输入的。l以下提到的out表示此参数是输出。l以下的“in，out”表示即使输入该参数也可以输出。l在以下叙述的音量设定中，默认的音量全部为100，设定为200时将音量放大两倍，设定为50时缩小一半，设定为0时放大静音，设定为10000时放大100倍。1.3开发时应注意的细节1.int、long的字长定义因编译器而异/int中有32位，int中有16位有些长为32位，有些长为64位-使用之前请仔细确认编译器的说明2 .使用保留的参数值时，必须全部使用0。 保留的字符参数为空字符，如下所示3 .函数上次执行的错误可以使用Q

4、NV_GetLastError获取，并返回32位错误值。 具体错误原因请参照错误文件的定义。函数原型： bri int 32 brisdklipqnx _ getlasterror ()；1.4驱动程序的安装方式1 :插入设备后，windows会提示您插入新硬件，并根据windows向导为驱动程序目录选择适当的驱动程序。方式2 :插入设备后，windows要求插入新硬件，取消此窗口，并执行开发包driver目录中的适当驱动程序评论：安装驱动程序后，主机更换USB端口后，windows提示插入新硬件时，需要重新安装。2接口函数。2.1打开设备(QNV_OpenDevice )2.1.1功能的说明

5、(Description )打开CC301设备/声卡/网络通信模块2.1.2函数原型(Function )bri int 32 qnv _ open设备(/*in*/BRIUINT32 uDevType/*in*/BRIUINT32 uValue/* in */bri char8*值；2.1.3返回值(返回值)大于0表示成功，其他情况表示失败.2.1.4参数的说明udev类型in指定要打开的设备的类型打开cc 301设备模块ODT_LBRIDGE功能说明(Description )打开CC301设备模块参数的说明输入 nvalue打开cc301设备参数0-打开所有CC301设备其

6、他-打开指定数量的CC301设备in pValue-保持返回值(Return Values )如果小于0，则返回失败，否则返回打开的设备数备注(Remarks )没有例如(Example )QNV_OpenDevice(ODT_LBRIDGE，0，0 )-打开所有CC301设备QNV_OpenDevice(ODT_LBRIDGE，16，0 )-打开前16个CC301设备，如果设备少至16个，则返回实际打开的数量打开声卡模块ODT_SOUND功能说明(Description )打开声卡模块参数的说明in nValue-保持in pValue-保持返回值(Return Values

7、)大于0表示成功，否则表示失败备注(Remarks )没有例如(Example )QNV_OpenDevice(ODT_SOUND，0，0 )打开网络CC模块PS _ S功能说明(Description )打开互联网即时/P2P语音/文件的CC模块参数的说明in nValue-保持输入值指定CC模块的许可证字符返回值(Return Values )大于0表示成功，否则表示失败备注(Remarks )-非特殊需要的用户使用的“quniccub_x”是license例如(Example )qnv _开放设备(ODT _ cc，0，quniccub_x )；2.1.5相关函数(See

8、Also )qnv _ close设备2.2关闭设备(QNV_CloseDevice )2.2.1功能的说明(Description )关闭指定的设备模块。2.2.2函数原型(Function )BRIINT32 QNV_CloseDevice (/*in*/BRIUINT32 uDevType/*in*/BRIUINT32 uValue；2.2.3返回值(返回值)带符号32比特大于0表示成功，除此以外表示失败.2.2.4参数的说明udev类型in指定要打开的设备的类型关闭cc 301设备模块ODT_LBRIDGE功能说明(Description )关闭CC301设备模块参数的说

9、明in nValue-保持返回值(Return Values )大于0表示成功，否则表示失败备注(Remarks )没有例如(Example )qnv _ close设备(ODT _ lbridge，0 )关闭声卡上的模块ODT_SOUND功能说明(Description )关闭声卡上的模块。参数的说明in nValue-保持返回值(Return Values )大于0表示成功，否则表示失败备注(Remarks )没有例如(Example )qnv _ close设备(ODT _ sound，0 )关闭网络CC模块PS _ S功能说明(Description )互联

10、网即时/P2P语音/文件的CC模块参数的说明in nValue-保持返回值(Return Values )大于0表示成功，否则表示失败备注(Remarks )没有例如(Example )qnv _ close设备(ODT _ cc，0 )关闭指定的频道ODT_CHANNEL功能说明(Description )关闭指定的频道参数的说明in nValue-保持返回值(Return Values )大于0表示成功，否则表示失败备注(Remarks )没有例如(Example )qnv _ close设备(ODT _ channel，1 )-关闭通道1 (第二个通道)2.3获取设备信息(

11、QNV_DevInfo )2.3.1功能的说明(Description )取得机器信息2.3.2函数的原型(Function )BRIINT32 QNV_DevInfo (/*in*/BRIINT16 nChannelID/*in*/BRIUINT32 uDevInfoType；2.3.3返回值(返回值)带符号32位-0以下表示失败。-其他表示成功2.3.4参数的说明nChannelIDin指定获取信息的通道编号/USB模块ID第一个通道nChannelID为0，依次增加uDevInfoTypein指定要获取信息的参数类型的值获取USB模块类型QNV_DEVINFO_GETCHI

12、PTYPE功能说明(Description )获取USB模块类型返回值(Return Values )0以下表示失败，其他表示USB的模块类型备注(Remarks )这个功能被预约了例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETCHIPTYPE )；获取USB模块数QNV_devinfo_getcchips功能说明(Description )获取USB模块数返回值(Return Values )小于0会失败，其他恢复的设备总共有几个USB芯片备注(Remarks )-此值与最后通道的设备ID 1.(QNV_DEVINFO_GETDEVID )相

13、同如果某些设备的USB芯片有两条通道，而USB芯片只有一条通道，则设备ID是通道ID例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETCHIPS )信道类型的获取QNV_DEVINFO_GETTYPE功能说明(Description )获取通道类型返回值(Return Values )如果小于0，则失败，其他返回设备的类型ID，具体ID中指定的信息会显示相关的定义备注(Remarks )没有例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETTYPE )；信道功能模块的获取qnv _ devinfo _

14、get模块功能说明(Description )获取频道功能模块。返回值(Return Values )如果小于0，则失败，返回设备具有的功能模块备注(Remarks )功能模块如下：(有关详细信息，请参见专用设备功能模块的定义。)DEVMODULE_DOPLAYDEVMODULE_POLARITY例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETMODULE )取得存在信道的USB芯片的转发IDQNV_DEVINFO_GETCHIPCHID功能说明(Description )获取通道所在的USB芯片的传输ID返回值(Return Values )如

15、果小于0，则表示失败，并且另一通道在USB芯片上返回一个转发id (0或1 )。备注(Remarks )一个USB芯片模块可能有两个传输信道。- 0表示第一个传输信道- 1表示第二个传输信道例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETCHIPCHID )取得频道序列号QNV_DEVINFO_GETSERIAL功能说明(Description )获取通道序列号。返回值(Return Values )如果小于0，则失败，并返回通道的设备序列号的值备注(Remarks )-序列号是32位的数字，不是字符串如果通道没有序列号，则返回0例如(Example )QNV_DevInfo(0，QNV_DEVINFO_GETSERIAL )；取得频道数QNV_DEVINFO_GETCHANNELS功