河北省高速公路收费软件摄像机动态库接口

摄像机类设备动态库接口文档V1.1.1动态库命名：（1）同时具备车牌识别、网络视频和字符叠加功能时，使用HGCamera.dll(2)只具备车牌识别功能时，使用HGCameraPlate.dll(3)只具备视频播放功能时，使用HGCameraVideo.dll1.1.1.1.1.1.资源初始化函数描述intCamera_Init()返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义功能申请足够的内存空间，保证后续运作备注1.1.1.1.1.2.释放资源函数描述intCamera_Deinit()返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义功能释放内存空间备注1.1.1.1.1.3.设置应用模式函数描述intCamera_SetUseMode(intnUseMode)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nUseModeint4应用模式，按位(车牌识别|视频|字符叠加)功能设置摄像机的应用模式备注设置摄像机应用模式，二进制位表示（1启用，0不启用）第一位表示是否启用车牌识别，第二位表示是否启用视频，第三位表示是否启用字符叠加1.1.1.1.1.4.连接设备函数描述intCamera_Login(intnType,char*sParas,int*pHandle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nTypeint4连接方式：0=串口，1=网络连接sParaschar*N连接信息：-串口：填“串口号”例“COM1”码”例“192.168.0.11,8000,admin,password”输出pHandleint*4*pHandle>0时连接成功，得到连接成功的句柄*pHandle<=0时连接失败功能主机与设备建立连接备注1.1.1.1.1.5.断开设备连接函数描述intCamera_Logout(intnHandle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄功能主机与设备断开连接备注1.1.1.1.1.6.设置识别结果回调函数描述intCamera_SetResultCallBack(intnHandle,CBFun_GetRegResultpFunc，void*pUser)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄pFuncCBFun_RspRegResult4识别结果回调函数NULL时，取消回调pUservoid*4用户自定义数据功能获得识别结果触发回调函数备注参考CBFun_GetRegResult。应用模式未设置车牌识别功能时，接口返回失败。识别结果回调定义CBFun_GetRegResult函数描述typedefvoid(*CBFun_GetRegResult)(intnHandle,T_VLPINFO*pVlpResultvoid*pUser)返回值返回值类型返回值说明void--参数出入参数名称类型长度含义输入nHandleint4设备句柄pVlpResultT_VLPINFO*4识别结果结构体pUservoid*4用户自定义数据功能解析抓拍识别结果备注typedef_vlp_info{intvlpInfoSize; //识别结构体大小intvlpCarClass; //车型unsignedcharvlpColor[2];//车牌颜色(数字编码)//“00”蓝色，“01”黄色，“02”黑色，“03”白色，”04”渐绿,“05”黄绿,“06”蓝白,”09”未识别unsignedcharvlpText[16];//车牌文字，GBKunsignedintvlpReliability; //识别车牌可信度(采用四位表示9999表示为99.99%)vovodpr函数描述tpedefvid(Fn_tx函数描述tpedefvid(Fn_txtaRlt)(intl,T_TAPIFO*pVlult化图，[3]=车身场景图，[4]=车尾场景图，[5]=额外识别信息}T_VLPINFO;1.1.1.1.1.7.设置额外识别结果回调函数描述intCamera_SetExtraResultCallBack(intnHandle,CBFun_GetExtraRegResultpFunc，void*pUser)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄pFuncCBFun_GetExtraRegResult4识别结果回调函数NULL时，取消回调pUservoid*4用户自定义数据功能获得额外识别结果触发回调函数备注参考CBFun_GetExtraRegResult。应用模式未设置车牌识别功能时，接口返回失败。识别结果回调定义CBFun_GetExtraRegResult函数描述函数描述intraauack(intl,intTiInl,Fun_tvttusFnc,)返回值返回值类型返回值说明void--参数出入参数名称类型长度含义输入nHandleint4设备句柄pVlpResultT_EXTRAVLPINFO*4识别结果结构体pUservoid*4用户自定义数据功能解析抓拍识别结果备注typedef_extra_vlp_info{charvlpId[32]; //识别车辆Id,格式“yyyyMMddHHmmss+3位自增数字”确保不会重复；intvlpInfoSize; //额外识别结构体大小intvlpExtraType; //额外识别数据类型1：车身图片2：车尾图片3：额外识别信息unsignedintimageLength;//识别数据长度unsignedchar*image; //识别数据}T_EXTRAVLPINFO;1.1.1.1.1.8.设置设备状态回调)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nTimeInvlint4状态汇报时间间隔pFuncCBFun_GetDevStatus4异常消息回调函数func=NULL时，取消回调pUservoid*4用户自定义数据功能设置回调，定时汇报设备运行状态或当设备发生异常时则立即回调备注参考CBFun_GetDevStatus设备状态回调定义CBFun_GetDevStatus函数描述typedefvoid(*CBFun_GetDevStatus)(intnHandle,intnStatus,void*pUser)返回值返回值类型返回值说明int--参数出入参数名称类型长度含义输入nHandleint4设备句柄nStatusint4错误码,0表示正常pUservoid*4用户自定义数据功能解析设备状态信息备注备注1.1.1.1.1.9.手动触发抓拍函数描述intCamera_ManualSnap(intnhandle)返回值返回值类型返回值说明Int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄功能手动触发抓拍识别，在识别回调函数中返回结果备注1.1.1.1.1.10.启动显示视频函数描述intCamera_StartDisplay(intnHandle,intnWidth,intnHeight,intnTop,intnLeft,intnFHandle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nWidthint4视频宽度nHeightint4视频高度nTopint4视频显示位置Y轴距离nLeftint4视频显示位置X轴距离nFHandleint4窗体句柄功能启动显示视频备注nTop,nLeft距离以nFHandle代表的窗体左上角为原点，若不支持该字口返回失败。1.1.1.1.1.11.停止显示视频函数描述intCamera_StopDisplay(intnHandle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄功能停止显示图像备注应用模式未设置视频功能时，接口返回失败。1.1.1.1.1.12.开始保存录像函数描述intCamera_StartSaveVideoData(intnHandle,constchar*sFileName,intnPreSeconds)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄sFileNamechar*n录像保存文件名nPreSecondsint4提前录制秒数，从接口调用n秒前开始保存录像功能保存视频录像到磁盘文件备注保存为MP4格式。1.1.1.1.1.13.完成保存录像函数描述intCamera_FinishSaveVideoData(intnHandle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄功能完成保存视频录像到磁盘文件备注应用模式未设置视频功能时，接口返回失败。1.1.1.1.1.14.获取图片函数描述函数描述intr_tIage(intl，intForat，cha*Ie，int*nLength)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nFormatint4获取图片的格式，0:bmp,1:jpeg,其他保留输出sImagechar*n存放抓拍图片的缓存，由外部申请和释放输出nLengthint4输入为缓存的最大长度，输出为抓拍图片实际长度功能获取图片备注应用模式未设置视频功能时，接口返回失败。1.1.1.1.1.15.获取图片文件函数描述intCamera_GetImageFile(intnHandle，intnFormat，char*sFileName)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nFormatint4获取图片的格式，0:bmp,1:jpeg,其他保留sFileNamechar*N抓拍图片文件名功能获取图片保存到指定的文件。备注应用模式未设置视频功能时，接口返回失败。1.1.1.1.1.16.字符叠加函数描述intCamera_TVPDisplay(intnHandle,intintnCol,char*)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nRowint4行位置，从1nColint4列位置，从1char*N叠加内容功能在屏幕上叠加文字备注叠加内容编码方式为GBK。应用模式未设置字符叠加功能时，接口返回失败。1.1.1.1.1.17.清除字符叠加函数描述函数描述intara_TPea(intnHandle,intintnCol,intnLength=1)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandlelong4设备句柄nRowint4length个字符；时表示清屏；col=0时表示清除一行。nColint4nLengthint4功能清除屏幕叠加内容备注应用模式未设置字符叠加功能时，接口返回失败。1.1.1.1.1.18.同步时间函数描述intCamera_SyncTime(intnHandle,char*)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄sSystimechar*14输入时间格式：yyyyMMddHHmmss功能与主机同步时间备注该函数只负责同步时间，不会显示时间1.1.1.1.1.19.设置时间显示格式函数描述intCamera_ShowTime(intnHandle,intnStyle)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄nStyleint4显示格式：0=不显示1=显示日期，格式为”yyyy-MM-dd”2=显示时间，格式为”HH:mm:ss””yyyy-MM-ddHH:mm:ss”功能按照格式要求显示时间备注调用本函数前，应与主机同步时间1.1.1.1.1.20.获取设备状态函数描述函数描述intara_GtSats(intnnde,int*pSttsCode)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nHandleint4设备句柄输出pStatusCodeint*4设备状态错误码，0表示正常版本功能获取设备运行状态备注1.1.1.1.1.21.获取错误码详细描述函数描述intCamera_GetStatusMsg(intnStatusCode,char*sStatusMsg,intnStatusMsgLen)返回值返回值类型返回值说明Int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输入nStatusCodeInt4错误码输出sStatusMsgchar*N错误码信息缓存地址输入nStatusMsgLenInt4错误码信息缓存长度功能查询错误码详细描述备注1.1.1.1.1.22.获取设备版本信息函数描述intchar*int)返回值返回值类型返回值说明int⚫ 0 操作成功⚫ 非0 错误码参数出入参数名称类型长度含义输出char*N版本信息缓存地址输入int4版本信息缓存长度功能获取顶棚牌版本信息备注1.1.1.1.1.23.摄像机错误码错误码 错误描述0 正常其他 待定义1.1.1.1.2.1.约束说明各个设备如果采用动态库方式提供接口调用，均按本小节的定义进行约束。Windows平台的动态库，采用WindowsAPI默认的函数调用协议：stdcall。➢ 非Windows平台的动态库，采用C/C++标准默认的函数调用协议。1.1.1.1.2.2.函数格式说明各设备接口定义的格式如下：D_EXTERN_CD_SHARE_EXPORTT_RETURND_CALLTYPEFunc(Paras);各个符号的定义如下：T_RETURN：返回类型Func：函数名称Paras：形参列表D_EXTERN_C，D_SHARE_EXPORT，D_CALLTYPE都为宏定义，具体的声明如下：#ifdefined(cplusplus)#defineD_EXTERN_Cextern"C"#else#defineD_EXTERN_C#endif#ifdefSHARE_EXPORT#defineD_SHARE_EXPORTD_DECL_EXPORT#else#defineD_SHARE_EXPORTD_DECL_IMPORT#endif#ifdefOS_