攝像機類設備動態庫接口文檔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_