大华网络SDK开发手册 下载本文

网络客户端SDK编程手册

位图文件名,当前只支持BMP位图

? 返回值:成功返回TRUE,失败返回FALSE ? 相关函数:CLIENT_RealPlay、

CLIENT_RealPlayEx、

CLIENT_PlayBackByRecordFile、CLIENT_PlayBackByRecordFileEx、CLIENT_PlayBackByTime、CLIENT_PlayBackByTimeEx

? 典型应用:对当前的显示画面进行瞬间抓图,无顺序要求

4.9 回放和下载

28. CLIENT_API BOOL CLIENT_QueryRecordFile(LONG lLoginID, int

nChannelId, int nRecordFileType, LPNET_TIME tmStart, LPNET_TIME tmEnd, char* pchCardid, LPNET_RECORDFILE_INFO nriFileinfo, int maxlen, int *filecount, int waittime=1200, bool bTime=false); ? 函数说明:查询录像文件 ? 参数说明:

lLoginID

CLIENT_Login的返回值

nChannelId

通道ID,从0开始 nRecordFileType

录像文件类型 0 所有录像文件 1 外部报警 2 动态检测报警 3 所有报警 4 卡号查询 5 组合条件查询 tmStart

录像开始时间 tmEnd

录像结束时间

pchCardid

卡号,只针对卡号查询有效 nriFileinfo

返回的录像文件信息,是一个NET_RECORDFILE_INFO结构数组 maxlen

nriFileinfo缓冲的最大长度;

filecount

返回的文件个数,属于输出参数最大只能查到缓冲满为止的录像记录;

第 37 页 共 93 页 网络客户端SDK编程手册

waittime

等待时间

bTime

是否按时间查(目前无效)

? 返回值:成功返回TRUE,失败返回FALSE

? 相关函数:CLIENT_Login、CLIENT_PlayBackByRecordFile、

CLIENT_PlayBackByRecordFileEx、CLIENT_PausePlayBackCLIENT_SeekPlayBack、CLIENT_StopPlayBackCLIENT_GetPlayBackOsdTime、CLIENT_StepPlayBackCLIENT_GetFramePlayBack、CLIENT_SetFramePlayBackCLIENT_SlowPlayBack、CLIENT_FastPlayBack

、、、、

? 典型应用:在回放之前需要先调用本接口查询录像记录,当根据输入的时间段

查询到的录像记录信息大于定义的缓冲区大小,则只返回缓冲所能存放的录像记录,可以根据需要继续查询

typedef void(CALLBACK *fDownLoadPosCallBack) (LONG lPlayHandle, DWORD dwTotalSize, DWORD dwDownLoadSize, DWORD dwUser);

29. CLIENT_API LONG CLIENT_PlayBackByRecordFile(LONG

lLoginID, LPNET_RECORDFILE_INFO lpRecordFile, HWND hWnd, fDownLoadPosCallBack cbDownLoadPos, DWORD dwUserData); ? 函数说明:网络回放,需要说明的是,用户登录一台设备后,每通道同一时间

只能播放一则录像,不能同时播放同一通道的多条记录。 ? 参数说明:

lLoginID

CLIENT_Login的返回值 lpRecordFile

录像文件信息, 当按时间播放是只需填充起始时间和结束时间, 其他项填0;

hWnd

回放窗口

cbDownLoadPos

进度回调函数 dwUserData

用户自定义数据

? 回调函数说明:

lPlayHandle

CLIENT_PlayBackByRecordFile的返回值

dwTotalSize

第 38 页 共 93 页 网络客户端SDK编程手册

指本次播放总大小,单位为KB dwDownLoadSize

指已经播放的大小,单位为KB,当其值为-1时表示本次回防结束 dwUser

用户数据,就是上面输入的用户数据

? 返回值:成功返回网络回放ID,失败返回0 ? 相关函数:CLIENT_Login、CLIENT_PausePlayBack,CLIENT_SeekPlayBack,

CLIENT_StopPlayBack、CLIENT_GetPlayBackOsdTime、

CLIENT_StepPlayBack、CLIENT_GetFramePlayBack、CLIENT_SetFramePlayBack、CLIENT_SlowPlayBack、CLIENT_FastPlayBack

? 典型应用:根据上面查询的记录,输入指定的显示窗口hWnd,调用本接口就可以播放了, 记录返回的播放ID,以下对本播放的控制都是要用此ID值,另外应用程序可以在此回调函数中处理和更新显示进度.

以下29、30、31为一组录像查询接口,和上面的录像查询接口独立

30. CLIENT_API LONG CALL_METHOD CLIENT_FindFile(LONG

lLoginID,int nChannelId,int nRecordFileType, char* cardid, LPNET_TIME time_start,LPNET_TIME time_end,bool bTime, int waittime); ? 函数说明:打开录像查询句柄 ? 参数说明:

lLoginID

CLIENT_Login的返回值

nChannelId

通道号,从0开始

nRecordFileType 录像文件类型 0 所有录像文件 1 外部报警 2 动态检测报警 3 所有报警 4 卡号查询 5 组合条件查询 Cardid

卡号,只针对卡号查询有效 Time_start

查询录像开始时间

第 39 页 共 93 页 网络客户端SDK编程手册

Time_end

查询录像结束时间

bTime

是否按时间查询(目前无效)

waittime

查询超时时间

? 返回值:成功返回查询句柄,失败返回0

? 相关函数:CLIENT_Login, CLIENT_FindNextFile, CLIENT_FindClose ? 典型应用:可以在回放之前先调用本接口查询录像记录,再调用

CLIENT_FindNextFile函数挨条返回录象记录用于播放,查询完毕可以调用CLIENT_FindClose关闭查询句柄。

31. CLIENT_API int CALL_METHOD CLIENT_FindNextFile(LONG

lFindHandle,LPNET_RECORDFILE_INFO lpFindData); ? 函数说明:查询下一条录像文件记录 ? 参数说明:

lFindHandle

CLIENT_FindFile的返回值

lpFindData

录象文件记录缓冲,用于输出查询到的录象文件记录

? 返回值:1:成功取回一条录象记录,0:录象记录已取完,-1:参数出错 ? 相关函数:CLIENT_FindFile

? 典型应用:调用本接口之前应先调用CLIENT_FindFile以打开查询句柄。

32. CLIENT_API BOOL CALL_METHOD CLIENT_FindClose(LONG

lFindHandle); ? 函数说明:关闭录象查询句柄 ? 参数说明:

lFindHandle

CLIENT_FindFile的返回值

? 返回值:成功返回TRUE,失败返回FALSE ? 相关函数:CLIENT_FindFile

? 典型应用:调用CLIENT_FindFile打开查询句柄,查询完毕后应调用本函数

以关闭查询句柄。

第 40 页 共 93 页