CC301二次开发接口文档重点详解.doc

CC301开发接口文档 文档名 CC301 API开发接口文档 起草人 Juju.chen 文档版本 2.5 起草日期 2009-09-01 更新日期 2013-11-21 技术支持方式 fanduansheng@ 前言 编写此文件目的 说明怎么样通过API控制CC301，以便第三方软件能更好利用CC301（如：CRM系统，办公软件等）无缝连接。 建议选择WORD菜单的”视图”-”文档结构图”的方式来浏览该文档的结构图 通用说明 以下提到的‘PSTN’为公共电话交换网，也就为接在设备line口的线路。 以下提到的话机/电话机为接在设备phone口的设备(如：普通模拟电话机/模拟交换机) 。 以下提到的内线也就为接在phone的设备(如：普通模拟电话机/模拟交换机) 。 以下提到的PC为接着CC301设备的电脑。 以下提到的参数类型 BRIINT64 - 表示有符号64bit(8字节) BRIINT32 - 表示有符号32bit(4字节) BRIUINT32 - 表示无符号32bit(4字节) BRIINT16 - 表示有符号16bit(2字节) BRIUINT16 - 表示有符号16bit(2字节) BRIBYTE8 - 表示无符号8bit(1字节) BRICHAR8 - 表示有符号8bit(1字节) BRIPCHAR8 - 表示字符串指针(ANSI) BRIPSHORT16 - 表示字符串指针(UNICODE) 以下提到的[in]表示该参数为输入。 以下提到的[out]表示该参数为输出。 以下提到的[in,out]表示该参数为输入也可以做输出。 以下提到的音量设置里的默认音量都为100，如果设置为200表示把音量放大一倍,如果为50就表示缩小一半,如果设置为0就表示为静音，如果为10000就表示把音量放大100倍。 开发时需要注意的细节 1.不同的编译器对int,long的字长定义不一样， 如：有些int为32位,有些int为16位 有些long为32位,有些long为64位 - 使用前请仔细查阅该编译器说明 2.使用保留的参数值时都必须使用0,保留的字符参数为空字符，如：”” 3.最后一次函数执行的错误可以使用QNV_GetLastError来获取,返回32位的错误值，具体错误原因查看错误文档定义。 函数原型: BRIINT32 BRISDKLIBAPI QNV_GetLastError(); 安装驱动 方式一：插入设备，windows会提示有新硬件插入，根据windows向导选择driver目录下相应的驱动。 方式二：插入设备，windows会提示有新硬件插入，取消该窗口，执行开发包driver目录下相应的驱动 备注： 当安装好驱动后，如果在主机换USB口后如果windows提示有新硬件插入，需要重新安装. 接口函数 打开设备 (QNV_OpenDevice) 功能描述 ( Description ) 打开CC301设备/声卡模块/网络通讯模块 函数原型 ( Function ) BRIINT32 QNV_OpenDevice( /*[in]*/ BRIUINT32 uDevType, /*[in]*/ BRIUINT32 uValue, /*[in]*/ BRICHAR8 *pValue); 返回值 ( Return Values ) 大于0表示成功,其它表示失败. 参数描述 (Parameters description) uDevType [in] 指定需要打开的设备类型 打开CC301设备模块ODT_LBRIDGE 功能描述 ( Description ) 打开CC301设备模块 参数介绍 ( Parameters ) [in] nValue 打开cc301设备参数 0 — 打开所有CC301设备 其它 — 打开指定数量的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 ) 打开声卡模块 参数介绍 ( Parameters ) [in] nValue – 保留 [in] pValue – 保留 返