河北省高速公路收費軟件攝像機動態(tài)庫接口

攝像機類設(shè)備動態(tài)庫接口文檔V1.1.1動態(tài)庫命名：（1）同時具備車牌識別、網(wǎng)絡(luò)視頻和字符疊加功能時，使用HGCamera.dll(2)只具備車牌識別功能時，使用HGCameraPlate.dll(3)只具備視頻播放功能時，使用HGCameraVideo.dll1.1.1.1.1.1.資源初始化函數(shù)描述intCamera_Init()返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義功能申請足夠的內(nèi)存空間，保證后續(xù)運作備注1.1.1.1.1.2.釋放資源函數(shù)描述intCamera_Deinit()返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義功能釋放內(nèi)存空間備注1.1.1.1.1.3.設(shè)置應(yīng)用模式函數(shù)描述intCamera_SetUseMode(intnUseMode)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nUseModeint4應(yīng)用模式，按位(車牌識別|視頻|字符疊加)功能設(shè)置攝像機的應(yīng)用模式備注設(shè)置攝像機應(yīng)用模式，二進制位表示（1啟用，0不啟用）第一位表示是否啟用車牌識別，第二位表示是否啟用視頻，第三位表示是否啟用字符疊加1.1.1.1.1.4.連接設(shè)備函數(shù)描述intCamera_Login(intnType,char*sParas,int*pHandle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nTypeint4連接方式：0=串口，1=網(wǎng)絡(luò)連接sParaschar*N連接信息：-串口：填“串口號”例“COM1”碼”例“192.168.0.11,8000,admin,password”輸出pHandleint*4*pHandle>0時連接成功，得到連接成功的句柄*pHandle<=0時連接失敗功能主機與設(shè)備建立連接備注1.1.1.1.1.5.斷開設(shè)備連接函數(shù)描述intCamera_Logout(intnHandle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄功能主機與設(shè)備斷開連接備注1.1.1.1.1.6.設(shè)置識別結(jié)果回調(diào)函數(shù)描述intCamera_SetResultCallBack(intnHandle,CBFun_GetRegResultpFunc，void*pUser)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄pFuncCBFun_RspRegResult4識別結(jié)果回調(diào)函數(shù)NULL時，取消回調(diào)pUservoid*4用戶自定義數(shù)據(jù)功能獲得識別結(jié)果觸發(fā)回調(diào)函數(shù)備注參考CBFun_GetRegResult。應(yīng)用模式未設(shè)置車牌識別功能時，接口返回失敗。識別結(jié)果回調(diào)定義CBFun_GetRegResult函數(shù)描述typedefvoid(*CBFun_GetRegResult)(intnHandle,T_VLPINFO*pVlpResultvoid*pUser)返回值返回值類型返回值說明void--參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄pVlpResultT_VLPINFO*4識別結(jié)果結(jié)構(gòu)體pUservoid*4用戶自定義數(shù)據(jù)功能解析抓拍識別結(jié)果備注typedef_vlp_info{intvlpInfoSize; //識別結(jié)構(gòu)體大小intvlpCarClass; //車型unsignedcharvlpColor[2];//車牌顏色(數(shù)字編碼)//“00”藍色，“01”黃色，“02”黑色，“03”白色，”04”漸綠,“05”黃綠,“06”藍白,”09”未識別unsignedcharvlpText[16];//車牌文字，GBKunsignedintvlpReliability; //識別車牌可信度(采用四位表示9999表示為99.99%)vovodpr函數(shù)描述tpedefvid(Fn_tx函數(shù)描述tpedefvid(Fn_txtaRlt)(intl,T_TAPIFO*pVlult化圖，[3]=車身場景圖，[4]=車尾場景圖，[5]=額外識別信息}T_VLPINFO;1.1.1.1.1.7.設(shè)置額外識別結(jié)果回調(diào)函數(shù)描述intCamera_SetExtraResultCallBack(intnHandle,CBFun_GetExtraRegResultpFunc，void*pUser)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄pFuncCBFun_GetExtraRegResult4識別結(jié)果回調(diào)函數(shù)NULL時，取消回調(diào)pUservoid*4用戶自定義數(shù)據(jù)功能獲得額外識別結(jié)果觸發(fā)回調(diào)函數(shù)備注參考CBFun_GetExtraRegResult。應(yīng)用模式未設(shè)置車牌識別功能時，接口返回失敗。識別結(jié)果回調(diào)定義CBFun_GetExtraRegResult函數(shù)描述函數(shù)描述intraauack(intl,intTiInl,Fun_tvttusFnc,)返回值返回值類型返回值說明void--參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄pVlpResultT_EXTRAVLPINFO*4識別結(jié)果結(jié)構(gòu)體pUservoid*4用戶自定義數(shù)據(jù)功能解析抓拍識別結(jié)果備注typedef_extra_vlp_info{charvlpId[32]; //識別車輛Id,格式“yyyyMMddHHmmss+3位自增數(shù)字”確保不會重復(fù)；intvlpInfoSize; //額外識別結(jié)構(gòu)體大小intvlpExtraType; //額外識別數(shù)據(jù)類型1：車身圖片2：車尾圖片3：額外識別信息unsignedintimageLength;//識別數(shù)據(jù)長度unsignedchar*image; //識別數(shù)據(jù)}T_EXTRAVLPINFO;1.1.1.1.1.8.設(shè)置設(shè)備狀態(tài)回調(diào))返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nTimeInvlint4狀態(tài)匯報時間間隔pFuncCBFun_GetDevStatus4異常消息回調(diào)函數(shù)func=NULL時，取消回調(diào)pUservoid*4用戶自定義數(shù)據(jù)功能設(shè)置回調(diào)，定時匯報設(shè)備運行狀態(tài)或當(dāng)設(shè)備發(fā)生異常時則立即回調(diào)備注參考CBFun_GetDevStatus設(shè)備狀態(tài)回調(diào)定義CBFun_GetDevStatus函數(shù)描述typedefvoid(*CBFun_GetDevStatus)(intnHandle,intnStatus,void*pUser)返回值返回值類型返回值說明int--參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nStatusint4錯誤碼,0表示正常pUservoid*4用戶自定義數(shù)據(jù)功能解析設(shè)備狀態(tài)信息備注備注1.1.1.1.1.9.手動觸發(fā)抓拍函數(shù)描述intCamera_ManualSnap(intnhandle)返回值返回值類型返回值說明Int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄功能手動觸發(fā)抓拍識別，在識別回調(diào)函數(shù)中返回結(jié)果備注1.1.1.1.1.10.啟動顯示視頻函數(shù)描述intCamera_StartDisplay(intnHandle,intnWidth,intnHeight,intnTop,intnLeft,intnFHandle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nWidthint4視頻寬度nHeightint4視頻高度nTopint4視頻顯示位置Y軸距離nLeftint4視頻顯示位置X軸距離nFHandleint4窗體句柄功能啟動顯示視頻備注nTop,nLeft距離以nFHandle代表的窗體左上角為原點，若不支持該字口返回失敗。1.1.1.1.1.11.停止顯示視頻函數(shù)描述intCamera_StopDisplay(intnHandle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄功能停止顯示圖像備注應(yīng)用模式未設(shè)置視頻功能時，接口返回失敗。1.1.1.1.1.12.開始保存錄像函數(shù)描述intCamera_StartSaveVideoData(intnHandle,constchar*sFileName,intnPreSeconds)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄sFileNamechar*n錄像保存文件名nPreSecondsint4提前錄制秒數(shù)，從接口調(diào)用n秒前開始保存錄像功能保存視頻錄像到磁盤文件備注保存為MP4格式。1.1.1.1.1.13.完成保存錄像函數(shù)描述intCamera_FinishSaveVideoData(intnHandle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄功能完成保存視頻錄像到磁盤文件備注應(yīng)用模式未設(shè)置視頻功能時，接口返回失敗。1.1.1.1.1.14.獲取圖片函數(shù)描述函數(shù)描述intr_tIage(intl，intForat，cha*Ie，int*nLength)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nFormatint4獲取圖片的格式，0:bmp,1:jpeg,其他保留輸出sImagechar*n存放抓拍圖片的緩存，由外部申請和釋放輸出nLengthint4輸入為緩存的最大長度，輸出為抓拍圖片實際長度功能獲取圖片備注應(yīng)用模式未設(shè)置視頻功能時，接口返回失敗。1.1.1.1.1.15.獲取圖片文件函數(shù)描述intCamera_GetImageFile(intnHandle，intnFormat，char*sFileName)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nFormatint4獲取圖片的格式，0:bmp,1:jpeg,其他保留sFileNamechar*N抓拍圖片文件名功能獲取圖片保存到指定的文件。備注應(yīng)用模式未設(shè)置視頻功能時，接口返回失敗。1.1.1.1.1.16.字符疊加函數(shù)描述intCamera_TVPDisplay(intnHandle,intintnCol,char*)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nRowint4行位置，從1nColint4列位置，從1char*N疊加內(nèi)容功能在屏幕上疊加文字備注疊加內(nèi)容編碼方式為GBK。應(yīng)用模式未設(shè)置字符疊加功能時，接口返回失敗。1.1.1.1.1.17.清除字符疊加函數(shù)描述函數(shù)描述intara_TPea(intnHandle,intintnCol,intnLength=1)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandlelong4設(shè)備句柄nRowint4length個字符；時表示清屏；col=0時表示清除一行。nColint4nLengthint4功能清除屏幕疊加內(nèi)容備注應(yīng)用模式未設(shè)置字符疊加功能時，接口返回失敗。1.1.1.1.1.18.同步時間函數(shù)描述intCamera_SyncTime(intnHandle,char*)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄sSystimechar*14輸入時間格式：yyyyMMddHHmmss功能與主機同步時間備注該函數(shù)只負責(zé)同步時間，不會顯示時間1.1.1.1.1.19.設(shè)置時間顯示格式函數(shù)描述intCamera_ShowTime(intnHandle,intnStyle)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄nStyleint4顯示格式：0=不顯示1=顯示日期，格式為”yyyy-MM-dd”2=顯示時間，格式為”HH:mm:ss””yyyy-MM-ddHH:mm:ss”功能按照格式要求顯示時間備注調(diào)用本函數(shù)前，應(yīng)與主機同步時間1.1.1.1.1.20.獲取設(shè)備狀態(tài)函數(shù)描述函數(shù)描述intara_GtSats(intnnde,int*pSttsCode)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nHandleint4設(shè)備句柄輸出pStatusCodeint*4設(shè)備狀態(tài)錯誤碼，0表示正常版本功能獲取設(shè)備運行狀態(tài)備注1.1.1.1.1.21.獲取錯誤碼詳細描述函數(shù)描述intCamera_GetStatusMsg(intnStatusCode,char*sStatusMsg,intnStatusMsgLen)返回值返回值類型返回值說明Int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸入nStatusCodeInt4錯誤碼輸出sStatusMsgchar*N錯誤碼信息緩存地址輸入nStatusMsgLenInt4錯誤碼信息緩存長度功能查詢錯誤碼詳細描述備注1.1.1.1.1.22.獲取設(shè)備版本信息函數(shù)描述intchar*int)返回值返回值類型返回值說明int? 0 操作成功? 非0 錯誤碼參數(shù)出入?yún)?shù)名稱類型長度含義輸出char*N版本信息緩存地址輸入int4版本信息緩存長度功能獲取頂棚牌版本信息備注1.1.1.1.1.23.攝像機錯誤碼錯誤碼 錯誤描述0 正常其他 待定義1.1.1.1.2.1.約束說明各個設(shè)備如果采用動態(tài)庫方式提供接口調(diào)用，均按本小節(jié)的定義進行約束。Windows平臺的動態(tài)庫，采用WindowsAPI默認的函數(shù)調(diào)用協(xié)議：stdcall。? 非Windows平臺的動態(tài)庫，采用C/C++標(biāo)準(zhǔn)默認的函數(shù)調(diào)用協(xié)議。1.1.1.1.2.2.函數(shù)格式說明各設(shè)備接口定義的格式如下：D_EXTERN_CD_SHARE_EXPORTT_RETURND_CALLTYPEFunc(Paras);各個符號的定義如下：T_RETURN：返回類型Func：函數(shù)名稱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_