您所在位置：主题：USB录音盒开发实例 sdk开发接口编程函数 API
13813857798
[专家分：0] 发布于 2011-10-10 10:14:00
子佩电话语音盒开发语言：
所有产品均支持vc,c#,vb,delphi,pb,c++build,foxpro,javascript,java 进行二次开发。二次开发包提供丰富的功能接口函数、完善的编程范例，我们还为您提供全面深入的电话技术支持。
。
利用子佩USB语音盒进行系统二次开发，公司为您提供多达26个型号的全系列USB语音盒产品及各种硬件解决方案可供选择。子佩全系列USB语音盒产品接口种类完善、开发包函数功能丰富、技术支持全面深入，售后服务高效完美，是您可信赖的合作伙伴！
接口函数
打开设备 (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 – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_OpenDevice(ODT_SOUND,0,0);
打开网络CC模块ODT_CC
功能描述 ( Description )
打开网络即时消息/P2P语音/文件的CC模块
参数介绍 ( Parameters )
[in] nValue – 保留
[in] pValue
指定CC模块的license 字符
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
- 非特殊需求的用户使用”quniccub_x”为license
例如 (Example)
QNV_OpenDevice(ODT_CC,0, “quniccub_x”);
相关函数 ( See Also )
QNV_CloseDevice
关闭设备(QNV_CloseDevice)
功能描述 ( Description )
关闭指定的设备模块
函数原型 ( Function )
BRIINT32 QNV_CloseDevice(
/*[in]*/ BRIUINT32 uDevType,
/*[in]*/ BRIUINT32 uValue);
返回值 ( Return Values )
有符号32bit位,大于0表示成功，其它表示失败.
参数描述 (Parameters description)
uDevType
[in] 指定需要打开的设备类型
关闭CC301设备模块ODT_LBRIDGE
功能描述 ( Description )
关闭CC301设备模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_LBRIDGE,0);
关闭声卡模块ODT_SOUND
功能描述 ( Description )
关闭声卡模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_SOUND,0);
关闭网络CC模块ODT_CC
功能描述 ( Description )
网络即时消息/P2P语音/文件的CC模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_CC,0);
关闭指定的通道ODT_CHANNEL
功能描述 ( Description )
关闭指定的通道
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_CHANNEL,1);
- 关闭通道1(第2个通道)
获取设备信息 (QNV_DevInfo)
功能描述 ( Description )
获取设备信息
函数原型 ( Function )
BRIINT32 QNV_DevInfo (
/*[in]*/BRIINT16 nChannelID,
/*[in]*/BRIUINT32 uDevInfoType);
返回值 ( Return Values )
有符号32bit位
小于等于0表示失败。
其它表示成功
参数描述 (Parameters description)
nChannelID
[in] 指定需要获取信息的通道号/USB模块ID
– 第一个通道nChannelID为0,依次递增
uDevInfoType
[in] 指定需要获取信息的参数类型值
获取USB模块类型QNV_DEVINFO_GETCHIPTYPE
功能描述 ( Description )
获取USB模块类型
返回值 ( Return Values )
小于等于0表示失败，其它表示USB的模块类型
备注 (Remarks)
该功能保留
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHIPTYPE);
获取USB模块数量QNV_DEVINFO_GETCHIPS
功能描述 ( Description )
获取USB模块数量
返回值 ( Return Values )
小于0表示失败，其它返回打开的设备里总共有几个USB芯片
备注 (Remarks)
- 该值等同于最后一个通道的设备ID+1.( QNV_DEVINFO_GETDEVID)
- 某些设备的一个USB芯片具有2个通道,当一个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_GETMODULE
功能描述 ( Description )
获取通道功能模块
返回值 ( Return Values )
小于0表示失败，返回设备拥有的功能模块
备注 (Remarks)
功能模块如：(详细信息查看专门的设备功能模块定义)
DEVMODULE_DOPLAY
…
DEVMODULE_POLARITY
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETMODULE);
获取通道所在USB芯片中的传输ID QNV_DEVINFO_GETCHIPCHID
功能描述 ( Description )
获取通道所在USB芯片中的传输ID
返回值 ( Return Values )
小于0表示失败，其它返回该通道在USB芯片里的传输ID.(0或者1)
备注 (Remarks)
一个USB芯片模块有可能拥有两个传输通道。
- 0表示第一个传输通道
- 1表示第二个传输通道
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHIPCHID);
获取通道序列号QNV_DEVINFO_GETSERIAL
功能描述 ( Description )
获取通道序列号
返回值 ( Return Values )
小于0表示失败，返回通道的设备序列号值
备注 (Remarks)
- 序列号为一个32bit的数值,不是字符串
- 如果该通道没有序列号返回0
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETSERIAL);
获取通道数量QNV_DEVINFO_GETCHANNELS
功能描述 ( Description )
获取通道数量
返回值 ( Return Values )
小于0表示失败，返回打开的总共的通道数量
备注 (Remarks)
- 有些一个设备拥有2个通道
- 该通道在USB里传输ID(QNV_DEVINFO_GETCHIPCHID)可能为0或者1
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHANNELS);
获取通道所在的USB模块ID QNV_DEVINFO_GETDEVID
功能描述 ( Description )
获取通道所在的USB模块ID
返回值 ( Return Values )
小于0表示失败，返回该通道所在的USB芯片ID
备注 (Remarks)
- 最后一个通道的USB模块ID也就为总共打开了几个USB芯片
- 某些设备的一个USB芯片具有2个通道,当一个USB芯片只有一个通道时，设备ID就是通道ID
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETDEVID);
获取开发包SDK里的DLL版本号QNV_DEVINFO_GETDLLVER
功能描述 ( Description )
获取开发包SDK里的DLL版本号
返回值 ( Return Values )
小于0表示失败，返回使用的SDK的DLL版本
备注 (Remarks)
当DLL新版本改进后该版本ID会发生变化，这样会有新的功能在低版本的DLL里不能使用，必须在指定的DLL版本以上
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETDLLVER);
文档下载 www.luyin888.com QQ1779637100
所有产品均支持vc,c#,vb,delphi,pb,c++build,foxpro,javascript,java 进行二次开发。二次开发包提供丰富的功能接口函数、完善的编程范例，我们还为您提供全面深入的电话技术支持。
。
利用子佩USB语音盒进行系统二次开发，公司为您提供多达26个型号的全系列USB语音盒产品及各种硬件解决方案可供选择。子佩全系列USB语音盒产品接口种类完善、开发包函数功能丰富、技术支持全面深入，售后服务高效完美，是您可信赖的合作伙伴！
接口函数
打开设备 (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 – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_OpenDevice(ODT_SOUND,0,0);
打开网络CC模块ODT_CC
功能描述 ( Description )
打开网络即时消息/P2P语音/文件的CC模块
参数介绍 ( Parameters )
[in] nValue – 保留
[in] pValue
指定CC模块的license 字符
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
- 非特殊需求的用户使用”quniccub_x”为license
例如 (Example)
QNV_OpenDevice(ODT_CC,0, “quniccub_x”);
相关函数 ( See Also )
QNV_CloseDevice
关闭设备(QNV_CloseDevice)
功能描述 ( Description )
关闭指定的设备模块
函数原型 ( Function )
BRIINT32 QNV_CloseDevice(
/*[in]*/ BRIUINT32 uDevType,
/*[in]*/ BRIUINT32 uValue);
返回值 ( Return Values )
有符号32bit位,大于0表示成功，其它表示失败.
参数描述 (Parameters description)
uDevType
[in] 指定需要打开的设备类型
关闭CC301设备模块ODT_LBRIDGE
功能描述 ( Description )
关闭CC301设备模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_LBRIDGE,0);
关闭声卡模块ODT_SOUND
功能描述 ( Description )
关闭声卡模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_SOUND,0);
关闭网络CC模块ODT_CC
功能描述 ( Description )
网络即时消息/P2P语音/文件的CC模块
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_CC,0);
关闭指定的通道ODT_CHANNEL
功能描述 ( Description )
关闭指定的通道
参数介绍 ( Parameters )
[in] nValue – 保留
返回值 ( Return Values )
大于0表示成功,其它表示失败
备注 (Remarks)
无
例如 (Example)
QNV_CloseDevice(ODT_CHANNEL,1);
- 关闭通道1(第2个通道)
获取设备信息 (QNV_DevInfo)
功能描述 ( Description )
获取设备信息
函数原型 ( Function )
BRIINT32 QNV_DevInfo (
/*[in]*/BRIINT16 nChannelID,
/*[in]*/BRIUINT32 uDevInfoType);
返回值 ( Return Values )
有符号32bit位
小于等于0表示失败。
其它表示成功
参数描述 (Parameters description)
nChannelID
[in] 指定需要获取信息的通道号/USB模块ID
– 第一个通道nChannelID为0,依次递增
uDevInfoType
[in] 指定需要获取信息的参数类型值
获取USB模块类型QNV_DEVINFO_GETCHIPTYPE
功能描述 ( Description )
获取USB模块类型
返回值 ( Return Values )
小于等于0表示失败，其它表示USB的模块类型
备注 (Remarks)
该功能保留
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHIPTYPE);
获取USB模块数量QNV_DEVINFO_GETCHIPS
功能描述 ( Description )
获取USB模块数量
返回值 ( Return Values )
小于0表示失败，其它返回打开的设备里总共有几个USB芯片
备注 (Remarks)
- 该值等同于最后一个通道的设备ID+1.( QNV_DEVINFO_GETDEVID)
- 某些设备的一个USB芯片具有2个通道,当一个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_GETMODULE
功能描述 ( Description )
获取通道功能模块
返回值 ( Return Values )
小于0表示失败，返回设备拥有的功能模块
备注 (Remarks)
功能模块如：(详细信息查看专门的设备功能模块定义)
DEVMODULE_DOPLAY
…
DEVMODULE_POLARITY
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETMODULE);
获取通道所在USB芯片中的传输ID QNV_DEVINFO_GETCHIPCHID
功能描述 ( Description )
获取通道所在USB芯片中的传输ID
返回值 ( Return Values )
小于0表示失败，其它返回该通道在USB芯片里的传输ID.(0或者1)
备注 (Remarks)
一个USB芯片模块有可能拥有两个传输通道。
- 0表示第一个传输通道
- 1表示第二个传输通道
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHIPCHID);
获取通道序列号QNV_DEVINFO_GETSERIAL
功能描述 ( Description )
获取通道序列号
返回值 ( Return Values )
小于0表示失败，返回通道的设备序列号值
备注 (Remarks)
- 序列号为一个32bit的数值,不是字符串
- 如果该通道没有序列号返回0
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETSERIAL);
获取通道数量QNV_DEVINFO_GETCHANNELS
功能描述 ( Description )
获取通道数量
返回值 ( Return Values )
小于0表示失败，返回打开的总共的通道数量
备注 (Remarks)
- 有些一个设备拥有2个通道
- 该通道在USB里传输ID(QNV_DEVINFO_GETCHIPCHID)可能为0或者1
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETCHANNELS);
获取通道所在的USB模块ID QNV_DEVINFO_GETDEVID
功能描述 ( Description )
获取通道所在的USB模块ID
返回值 ( Return Values )
小于0表示失败，返回该通道所在的USB芯片ID
备注 (Remarks)
- 最后一个通道的USB模块ID也就为总共打开了几个USB芯片
- 某些设备的一个USB芯片具有2个通道,当一个USB芯片只有一个通道时，设备ID就是通道ID
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETDEVID);
获取开发包SDK里的DLL版本号QNV_DEVINFO_GETDLLVER
功能描述 ( Description )
获取开发包SDK里的DLL版本号
返回值 ( Return Values )
小于0表示失败，返回使用的SDK的DLL版本
备注 (Remarks)
当DLL新版本改进后该版本ID会发生变化，这样会有新的功能在低版本的DLL里不能使用，必须在指定的DLL版本以上
例如 (Example)
QNV_DevInfo(0, QNV_DEVINFO_GETDLLVER);
文档下载 www.luyin888.com QQ1779637100