大华网络SDK开发手册

1、大 华 网 络 S D K 编 程 手 册VERSION 3.1.8(Build 070321)2007-3-21版权所有 侵权必究非常感谢您使用我们公司的设备，我们将为您提供最好的服务。本手册可能包含技术上不准确的地方或印刷错误，欢迎指正。我们将会定期更新手册的内容。修订记录日期修订内容作者2006-05-30创建林峰2006-7-3修订接口描述冯江2006-7-5修订概要描述华立高2006-7-26修订接口描述刘杰陈美英2006-8-10冋步更新接口描述陈美英2006-8-21修订接口描述陈美英2006-8-23增加典型调用顺序描述陈美英2006-8-283.0.0整理修订陈美英2006-

2、9-153.0.5冋步增加回调数据扩展接口，更新云台控制说明陈美英2006-9-213.0.7同步增加登录扩展接口陈美英2006-9-293.0.9同步增加带有配置结构的配置功能接口说明陈美英2006-10-16增加单独修改通道名称的接口赵均树2006-10-21增加打开实时图像的扩展接口赵均树2006-10-281、增加按时间回放和下载接口2、增加设备配置的第三方接入和获取设备的序列号功能赵均树2006-11-81、带数据回调的按时间回放扩展接口2、带数据回调的按文件回放扩展接口3、远程重启接口4、录像回放能够播放音频赵均树、陈琼施2006-11-191、 解决了反复修改第三方的IP地址时D

3、VR比较容易死 机的问题2、增加485接口3、通过网络修改IP配置时DVR重启赵均树、陈琼施2006-11-271、增加DDNS查询IP的功能赵均树、陈琼施2006-12-15修正文档中接口描述的错误，并增加链接赵均树、陈琼施、林坚彦2006-12-25增加并修改语音对讲的接口叶浩、陈琼施2006-12-29增加用户管理接口林坚彦、陈琼施2007-1-17修改了 CLIENT_Login 的功能描述增加了 CLIENT_FindFile、CLIENT_FindNextFile 、 CLIENT FindClose林坚彦、赵均树、陈琼施2007-2-8增加了设备参数配置的两个接口：CLIENT_

4、GetDevCo nfig CLIENT_SetDevCo nfig林坚彦、陈琼施、 赵均树2007-3-7修改了 CLIENT StopListen接口典型应用的笔误赵均树2007-03-19增加了个查询报警状态的接口。林坚彦、陈琼施2007-03-21增加了语音对讲中的音频编码接口叶浩、陈琼施、林坚彦增加了扩展报警侦听接口1 简 介1.1 概述欢迎使用大华网络SDK编程手册，网络客户端软件开发包（DVR客户端SDK）是 大华网络硬盘录像机、网络视频服务器的配套产品，本文档详细描述了开发包中各个函 数实现的功能、接口及其函数之间的调用关系和示例实现。网络客户端软件开发包主要包括业务操作和设备

5、管理两大部分：业务操作 ：状态侦听、实时监视、实时预览、字符叠加、音频控制、录像回放和下载、 数据保存、云台控制、语音对讲、透明串口、码流统计等功能。设备管理 ：远程升级、远程重启 /关闭、设备参数配置（系统通用配置、报警布 /撤防 设置、录像配置、 串口配置、图像配置、日志管理、用户管理、设备校时、 动态检测配置、网络配置）等功能。开发包所包括的文件有：网络库：、解码库：、辅助库：、1.2 适用性支持所有大华网络硬盘录像机（DVR ）、网络视频服务器（NVS ）、网络报警服务器（ NAS）只支持 TCP 网络传输模式客户端可以采用多种分辨率进行图像预览， 支持的分辨率包括： QCIF、CIF

6、、2CIF、HalfDI、D1, VGA （640>480）等 客户端支持多种图像编码，包括 MPEG4 和等1.3 特色功能支持设备的以下特色功能：多路预览在窄带条件下，同时多路实时监视对带宽的要求比较高， 一般的处理情况有两种， 其一，轮巡。其二，多路预览。所谓多路预览，就是在一个通道上把所有通道的数据 组织在一起传输，等同于多路同时监视。必要的时候，可以转单路监视。大华 DVR 支持多路预览功能。支持标准的 MP4 数据一般情况下， 同一平台集成不同厂商的前端设备 （如 DVR） ，由于各厂商采用的 视频压缩方法不同 （包括算法、参数定义等 ），导致解码端回放必须采用厂商特定的工

7、具，造成平台开发商无法自定义播放标准。本 SDK 能够解决这个问题。通过特定接 口，应用层可以通过本 SDK获取标准媒体数据（FOURCD'、V X视频数据），要支持用各种通用播放器播放，有了提供标准数据，应用层只须打包标准数 据到播放器支持的容器类型 （也就是文件格式 ,如 AVI 标准）就可以了。2设计原则2.1编程说明初始化和清除1、 使用网络客户端软件包首先调用对系统进行初始化，应用程序退出时调用释放所 有占用的资源。2、大多数函数调用均应该在之后，之前，除了少数函数，譬如CLIENT_SetCo nn ectTime()在之前调用，而可以在任何时候调用等等。操作句柄系统设计上

8、多处使用了句柄概念，很多操作均针对句柄，如回放、下载以及语音 对讲等。用户登录和注销用户在访问前端设备之前必须通过调用登录到前端设备上，登录成功后返回一 个全局唯一的句柄。此句柄就像一个会话通道，之后该用户可通过此句柄访问前端 设备。退出该会话时则通过函数在前端设备上注销此句柄以终止该会话通道的使用。 建立连接与登录是同步的。心跳功能在本开发包中提供自动心跳功能(20秒一次心跳)当设备断开能及时回调给客户端。同步与异步异步以设置回调函数来响应网络数据，有些异步在设置后返回请求句柄，结束 请求时将请求句柄提供给SDK以注销相关资源。SDK提供协议探测和转换回调函数一般都有dwUser参数,由用户

9、自定义需要的数据,一般用来传入类对象指针, 方便回调处理在类中实现，回调应用都可以采取这种方式。2.2典型调用顺序初始化SDK 初始化CLIENT_Init()A.SDK功能设置或信息获取B.设置连接等待时间CLIENT SetCo nn ectTime()获取 SDK 版本CLIENT_GetSDKVersion()设置消息回调CLIENT_SetDVRMessCallBack()设置自定义叠加画板 CLIENT RigisterDrawFu n()C.登录连接设备登录设备开始侦听CLIENT_Logi n() CLIENT StartListe n()D.设备功能操作与信息获取系统配置CL

10、IENT_QueryCo nfig()获取设备状态CLIENT_SetupCo nfig()CLIENT_GetDEVWorkState()获取协议信息CLIENT_QueryComProtocol()查询获取系统信息CLIENT_QuerySystemI nfo()查询通道名称CLIENT_QueryCha nn elName()查询日志CLIENT_QueryLogCallback()用户管理CLIENT_QueryLog()CLIENT_QueryUserI nfo()云台控制CLIENT_OperateUserl nfo() CLIENT_PTZC on trol()语音对讲CLIEN

11、T_DHPTZC on trol()CLIENT_StartTalk()设置限流CLIENT_Se ndTalkData_Custom() CLIENT_StopTalk()CLIENT_SetMaxFlux()透明串口CLIENT_CreateTra nsComCha nn el()CLIENT_Se ndTra nsComData()CLIENT DestroyTransComChanne()E.实时监视通道打开监视通道保存监视图像数据 监视数据回调保存获取视频参数信息 设置修改视频参数 强制I帧CLIENT_RealPlay() CLIENT_RealPlayEx() CLIENT_Sa

12、veRealData() CLIENT_SetRealDataCallBack() CLIENT_SetRealDataCallBackEx() CLIENT_Clie ntGetVideoEffect() CLIENT_Clie ntSetVideoEffect() CLIENT MakeKeyFrameOF.多画面预览通道查询录像 回放及控制下载打开多画面预览CLIENT_MultiPlay()停止多画面预览CLIENT_StopMultiPlay()G.回放/下载通道CLIENT_QueryRecordFile()CLIENT_PlayBackByRecordFile() CLIENT_

13、PlayBackByRecordFileEx() CLIENT_PlayBackByTime() CLIENT_PlayBackByTimeEx() CLIENT_GetPlayBackOsdTime()CLIENT_PausePlayBack()CLIENT_SeekPlayBack()CLIENT_StopPlayBack()CLIENT_StepPlayBack() CLIENT_FastPlayBack() CLIENT_SlowPlayBack() CLIENT_GetFramePlayBack() CLIENT_SetFramePlayBack() CLIENT_Dow nload

14、ByRecordFile() CLIENT_Dow nloadByRecordFileEx() CLIENT_Dow nloadByTime() CLIENT_StopDow nload()CLIENT GetDownloadPos()针对显示图像的操作（监视/回放/多画面预览）抓图 码流统计 打开音频CLIENT_C apturePicture() CLIENT_GetStatiscFlux() CLIENT_Ope nSou nd() CLIENT_SetVolume()设置曰里I. 远程控制远程升级CLIENT_StartUpgrade CLIENT_Se ndUpgrade CLIEN

15、T_StopUpgrade录像控制CLIENT_QueryRecordStateCLIENT_SetupRecordState系统校时CLIENT_QueryDeviceTimeCLIENT_SetupDeviceTimeIO控制CLIENT QueryIOControlStateCLIENT_IOCo ntrol注销断开设备停止侦听 断开连接CLIENT_StopListe n() CLIENT_Logout()释放SDK资源SDK退出CLIENT_Clea nup()丄K.对D E、F、G H I中的功能大部分之间没有调用先后顺序，当然对同一个功能还是 应该按先打开再操作最后关闭的顺序。3

16、数据结构定义3.1客户端数据结构通用云台控制命令1100110111021103日志的结构形式typedef enum _PTZ_C on trolType PTZ_UP_CONTROL = 0,日志的类型enum dh_log_tLOG_REBOOT = 0x0000,向客户端传递所有日志信息，长度为数据组织N*日志结构长度，N为日志的条数。查询硬盘信息的返回数据结构typedef structDWORD dwDiskNum;码不正确2帐号不存在3等待登录返回超时4.帐号已登录5帐号已被锁定6帐号又被列为黑名单7资源不足，系统忙9找不到网络主机0其他网络错误返回值：失败返回0,成功返回设备I

17、D，登录成功之后对设备的操作都可以 通过此值（设备句柄）对应到相应的设备相关函数： 典型应用：在初始化后就可以调用本接口注册到指定的设备，成功后将返回 设备句柄，给相关的函数调用1. CLIENT_API LONG CLIENT_LoginEx(char *pchDVRIP, WORD wDVRPort, char *pchUserName, char *pchPassword, int nSpecCap, void* pCapParam, LPNET_DEVICEINFO lpDeviceInfo, int *error = 0)函数说明：注册用户到设备的扩展接口，支持一个用户指定设备支持的

18、能力 参数说明：增加扩展参数nSpecCap设备支持的能力， 值为 1 表示同一用户名可以多次登录 , 其他暂时不 支持pCapParam对 nSpecCap 的补充参数 , 目前为 0返回值：失败返回0,成功返回设备ID，登录成功之后对设备的操作都可以 通过此值 (设备句柄 )对应到相应的设备相关函数： 典型应用：一个用户同时多次登录同一台设备2. CLIENT_API BOOL CLIENT_Logout(LONG lLoginID);函数说明：注销设备用户参数说明： lLoginID的返回值返回值：成功返回TRUE，失败返回FALSE相关函数： 典型应用：当需要设备主动断开时调用 ;3.

19、2 实时监视3. CLIENT_API LONG CLIENT_RealPlay(LONG lLoginID, int nChannelID, HWND hWnd);函数说明：启动实时监视参数说明：lLoginID的返回值nChannelID实时监视通道号 (通道号从 0 开始 )hWnd窗口句柄，值为 0 对数据不解码、不显示图像返回值：失败返回0,成功返回实时监视ID(实时监视句柄)，将作为相关函 数的参数 相关函数：、 典型应用：根据登录时获取到的设备信息 ,调用本接口 ,就可以打开任何有效的 一路实时监视 ,显示到指定的 hWnd 窗口,正常返回的监视 ID, 用于以下对本监 视通道的

20、控制和操作 ;4. CLIENT_API BOOL CLIENT_StopRealPlay(LONG lRealHandle); 函数说明：停止实时监视 参数说明： lRealHandle的返回值返回值：成功返回TRUE，失败返回FALSE 相关函数：典型应用：关闭失实监视5. CLIENT_API LONG CALL_METHOD CLIENT_RealPlayEx(LONG lLoginID, int nChannelID, HWND hWnd, RealPlayType rType) 函数说明：启动实时监视或多画面预览，当打开多画面预览时不能打开语音 对讲参数说明：lLoginID的返回

21、值nChannelID实时监视通道号，如果 rType 为 RType_Multiplay 该参数保留。 hWnd窗口句柄，值为 0 对数据不解码、不显示图像 rType数据类型 RType_Realplay = 0, 1f1f.BYTE format ;11025 1200以下 29、30、31 为一组录像查询接口 ,和上面的录像查询接口独立6. CLIENT_API LONG CALL_METHODCLIENT_FindFile(LONGlLoginID, int nChannelId, int nRecordFileType, char * cardid, LPNET_TIME time

22、_start,LPNET_TIME time_end,bool bTime, int waittime);函数说明：打开录像查询句柄 参数说明：lLoginID的返回值nChannelId 通道号，从 0 开始nRecordFileType录像文件类型0所有录像文件1 外部报警2 动态检测报警3 所有报警4 卡号查询5 组合条件查询Cardid卡号 ,只针对卡号查询有效Time_start 查询录像开始时间Time_end查询录像结束时间bTime是否按时间查询 (目前无效 ) waittime查询超时时间 返回值：成功返回查询句柄，失败返回 0 相关函数：， ，典型应用： 可以在回放之前先调

23、用本接口查询录像记录 ,再调用 函数挨条返 回录象记录用于播放，查询完毕可以调用关闭查询句柄。7. CLIENT_API int CALL_METHOD CLIENT_FindNextFile(LONG lFindHandle,LPNET_RECORDFILE_INFO lpFindData);函数说明：查询下一条录像文件记录 参数说明： lFindHandle的返回值 lpFindData录象文件记录缓冲，用于输出查询到的录象文件记录 返回值： 1：成功取回一条录象记录， 0：录象记录已取完， 1：参数出错 相关函数： 典型应用：调用本接口之前应先调用以打开查询句柄。8. CLIENT_AP

24、I BOOL CALL_METHOD CLIENT_FindClose(LONG lFindHandle);函数说明：关闭录象查询句柄 参数说明： lFindHandle的返回值返回值：成功返回TRUE，失败返回FALSE 相关函数：9.典型应用：调用打开查询句柄，查询完毕后应调用本函数以关闭查询句柄。 CLIENT_APILONGCALL_METHODlLoginID,HWND hWnd,CLIENT_PlayBackByRecordFileEx(LONGLPNET_RECORDFILE_INFO lpRecordFile,fDownLoadPosCallBackcbDownLoadPos,

25、DWORD dwPosUser,fDataCallBack fDownLoadDataCallBack, DWORD dwDataUser);函数说明： 带数据回调的按录象文件回放扩展接口 ,每通道同一时间只能播放 一则录像,不能同时播放同一通道的多条记录。窗口参数（ hWnd）有效时不 回调数据，如果需要数据回调则窗口参数.（hWnd）必须传0。参数说明：lLoginID的返回值lpRecordFile 录像文件信息hWnd回放窗口cbDownLoadPos进度回调函数dwPosUser进度回调用户参数进度回调函数参数说明：参见dwDataUser数据回调用户数据回调函数参数说明：lReal

26、HandleCLIENT_PlayBackByRecordFileEx的返回值dwDataType这里为 0（原始数据 ）pBuffer数据缓冲dwBufSize 缓冲长度 fDownLoadDataCallBack 数据回调函数，原形参见典型应用 dwUser 用户数据，就是上面输入的用户数据 dwDataUser 注意】 本回调函数的返回值会影响 SDK 的内部操作： 返回 1代表回调成功，没什么特殊情况都应该返回这个值返回 0代表回调函数堵塞，这个会导致同一数据重复发送，即回放画面会出现重复 返回 1 代表系统出错，将直接结束回放线程，慎用！返回值：成功返回网络回放 ID ，失败返回 0

27、相关函数 ：、，、典 型 应 用 ： 如 果 窗 口 参 数 hWnd 不 为 零 ， 则 数 据 回 调 参 数(fDownLoadDataCallBack，dwDataUser )无效，如果窗口参数 hWnd为零,则回调原形为：typedef int(CALLBACK *fDataCallBack) (LONG lRealHandle, DWORDdwDataType, BYTE *pBuffer, DWORD dwBufSize, DWORD dwUser);10. CLIENT_API LONG CALL_METHOD CLIENT_PlayBackByTime(LONG lLogin

28、ID, int nChannelID, LPNET_TIME lpStartTime, LPNET_TIME lpStopTime,HWND hWnd, fDownLoadPosCallBackcbDownLoadPos, DWORD dwUserData);函数说明：网络回放 ,需要说明的是对同一设备的同一通道当前只能同时播放 一个时间段录像 参数说明： lLoginID的返回值nChannelID图像通道号，从 0 开始，必须指定lpStartTime开始时间lpStopTime结束时间hWnd回放窗口 cbDownLoadPos进度回调函数dwUserData 用户自定义数据进度回调函数

29、参数说明：参见返回值：成功返回网络回放 ID ，失败返回 0 相关函数：、，、典型应用：参见 demo11. CLIENT_API LONG CALL_METHOD CLIENT_PlayBackByTimeEx(LONG lLoginID, int nChannelID, LPNET_TIME lpStartTime, LPNET_TIME lpStopTime,HWND hWnd, fDownLoadPosCallBackcbDownLoadPos, DWORD dwPosUser, fDataCallBack fDownLoadDataCallBack, DWORD dwDataUser

30、);函数说明：带数据回调的按时间回放扩展接口 , 每通道同一时间只能播放一 贝U录像,不能同时播放同一通道的多条记录。窗口参数(hWnd)有效时不回调数据，如果需要数据回调则窗口参数.(hWnd必须传0。参数说明：lLoginID的返回值nChannelID图像通道号，必须指定lpStartTime开始时间lpStopTime结束时间hWnd回放窗口cbDownLoadPos进度回调函数dwPosUser进度回调用户参数进度回调函数参数说明：参见 fDownLoadDataCallBack 数据回调函数dwDataUser数据回调用户数据回调函数参数说明参见：的数据回调函数参数说明。注意】 本

31、回调函数的返回值会影响 SDK 的内部操作：返回 1 代表回调成功，没什么特殊情况都应该返回这个值。返回 0 代表回调函数堵塞，这个会导致同一数据重复发送，即回放画面会出现重复;返回 1 代表系统出错，将直接结束回放线程，慎用！返回值：成功返回网络回放 ID ，失败返回 0 相关函数：、，、 典 型 应 用 ： 如 果 窗 口 参 数 hWnd 不 为 零 ， 则 数 据 回 调 参 数 ( fDownLoadDataCallBack，dwDataUser )无效，如果窗口参数 hWnd 为零 ,则回调原形为：typedef int(CALLBACK *fDataCallBack) (LONG

32、 lRealHandle, DWORD dwDataType, BYTE *pBuffer, DWORD dwBufSize, DWORD dwUser); 参见 demo12. CLIENT_API BOOL CLIENT_StopPlayBack(LONG lPlayHandle);函数说明：网络回放停止参数说明：lPlayHandle的返回值返回值：成功返回TRUE，失败返回FALSE相关函数：、典型应用：输入上一接口返回的播放ID,调用本接口就可以停止控制13. CLIENT_APIBOOL CLIENT_GetPlayBackOsdTime(LONGlPlayHandle, LPNE

33、T_TIME lpOsdTime, LPNET_TIME lpStartTime, LPNET_TIME lpEndTime);函数说明：得到当前网络回放的 OSD时间，只有打开图像的函数参数 hWnd 有效时该函数获取的参数才有效，否则无意义参数说明：lPlayHandle的返回值lpOsdTimeOSD 的时间lpStartTime开始时间lpEndTime结束时间返回值：成功返回TRUE，失败返回FALSE相关函数：、参见 demo14. CLIENT_APILONG CLIENT_DownloadByRecordFile(LONGlLoginID,LPNET_RECORDFILE_IN

34、FO lpRecordFile,char*sSavedFileName,fDownLoadPosCallBack cbDownLoadPos,DWORD dwUserData);函数说明：下载录像文件 , 通过查询到的文件信息下载 参数说明：lLoginID的返回值lpRecordFile 录像文件信息指针 , 当需要按时间段下载时直接填充开始时间和结束时 间 , 其他项填 0sSavedFileName 要保存的录像文件名，全路径cbDownLoadPos下载进度回调函数dwUserData 下载进度回调用户自定义数据下载进度回调函数参数说明：参见返回值：成功返回下载ID，失败返回0相关函数

35、：、，典型应用：根据上面查询的记录 ,就可以将录像保存到指定的文件 ,下载进度回 调与回放进度类似15. CLIENT_API LONG CALL_METHOD CLIENT_DownloadByTime(LONG lLoginID, int nChannelId, int nRecordFileType, LPNET_TIME tmStart, LPNET_TIME tmEnd, char *sSavedFileName, fTimeDownLoadPosCallBack cbTimeDownLoadPos, DWORD dwUserData);函数说明：直接输入指定通道起始时间和结束时间下

36、载放录像 参数说明： lLoginID的返回值nChannelId图像通道号，从 0 开始nRecordFileType保留tmStart开始时间tmEnd结束时间sSavedFileName要保存的录像文件名，全路径 cbTimeDownLoadPos下载进度回调函数dwUserData 下载进度回调用户自定义数据下载进度回调函数参数说明参见返回值：成功返回下载 ID ，失败返回 0相关函数 ：，典型应用：参见 demo16. CLIENT_API BOOL CLIENT_StopDownload(LONG lFileHandle);函数说明：停止下载录像文件参数说明：lFileHandle

37、的返回值返回值：成功返回TRUE，失败返回FALSE相关函数：、 典型应用：根据需要可以等文件下载完了关闭下载 ,也可以下载到一部分停止 下载;17. CLIENT_API BOOL CLIENT_GetDownloadPos(LONG lFileHandle, int *nTotalSize, int *nDownLoadSize);函数说明：获得下载录像的当前位置 ,可以用于不需要实时显示下载进度的接 口,与下载回调函数的功能类似 参数说明： lFileHandle 的返回值nTotalSize下载的总长度nDownLoadSize已下载的长度返回值：成功返回TRUE，失败返回FALSE相

38、关函数：、 典型应用：用于不打算通过回调计算进度 ,可定时调用本接口获取当前进度 ;3.3 回放控制18. CLIENT_API BOOL CLIENT_PausePlayBack(LONG lPlayHandle, BOOL bPause);函数说明：网络回放暂停与恢复播放，只有打开图像的函数参数 hWnd 有效 时该函数获取的参数才有效，否则无意义参数说明：lPlayHandle的返回值bPause网络回放暂停与恢复播放参数1 暂停0 恢复返回值：成功返回TRUE，失败返回FALSE 相关函数：、 典型应用：对已经打开的播放进行暂停和恢复控制19. CLIENT_API BOOL CLIE

39、NT_SeekPlayBack(LONG lPlayHandle, unsigned int offsettime, unsigned int offsetbyte);函数说明：改变位置播放 ,即拖动播放，只有打开图像的函数参数 hWnd 有效 时该函数获取的参数才有效，否则无意义参数说明： lPlayHandle的返回值offsettime 相对文件开始处偏移时间，单位为秒.当其值为 0xffffffff 时 ,该参数无效 .offsetbyte相对文件开始处偏移字节 , 当其值为 0xffffffff 时 , 该参数无效；当offsettime 有效的时候 , 此参数无意义 .返回值：成功

40、返回TRUE，失败返回FALSE 相关函数：、，典型应用：对已经打开的播放进行定位播放控制 ,一般用于拖动进度条控制20. CLIENT_API BOOL CLIENT_StepPlayBack(LONG lPlayHandle, bool bStop);函数说明：单步播放 , 调用一次播放一帧图像，只有打开图像的函数参数 hWnd 有效时该函数获取的参数才有效，否则无意义 参数说明： lPlayHandle的返回值bStop 是否停止单步播放 , 在结束单步时调用 返回值：成功返回TRUE，失败返回FALSE 相关函数 : 、典型应用：用于对关键数据的单帧播放,并且bStop要设置为TRUE

41、,切换到 其他播放之前要再调用本接口关闭单步播放才能正常执行其他的播放模式21. CLIENT_API BOOL CLIENT_FastPlayBack(LONG lPlayHandle); 函数说明：快放 ,将当前帧率提高一倍 ,但是不能无限制的快放 ,目前最大 120, 大于时返回 FALSE, 有音频的话不可以快放，慢放没有问题，只有打开图像 的函数参数hWnd有效时该函数获取的参数才有效，否则无意义参数说明： lPlayHandle的返回值返回值：成功返回TRUE，失败返回FALSE 相关函数: ，、 典型应用：要求快镜头播放的情况22. CLIENT_API BOOL CLIENT_

42、SlowPlayBack(LONG lPlayHandle); 函数说明：慢放,将当前帧率降低一倍 ,最慢为每秒一帧 ,小于 1则返回 FALSE， 只有打开图像的函数参数hWnd有效时该函数获取的参数才有效，否则无意 义参数说明：lPlayHandle的返回值返回值：成功返回TRUE，失败返回FALSE 相关函数: ，、 典型应用：要求慢动作播放的情况23. CLIENT_API BOOL CLIENT_SetFramePlayBack(LONG lPlayHandle, int framerate);函数说明：设置回放帧率 , 目前定义的范围是 (1120),超过这个范围返回FALSE，只

43、有打开图像的函数参数 hWnd有效时该函数获取的参数才有效, 否则无意义 参数说明： lPlayHandle 的返回值 framerate 帧率返回值：成功返回TRUE，失败返回FALSE相关函数: 、 典型应用：自设定帧率播放 ,24. CLIENT_API BOOL CLIENT_GetFramePlayBack(LONG lPlayHandle, int *fileframerate, int *playframerate);函数说明：得到当前回放帧率，只有打开图像的函数参数 hWnd 有效时该函 数获取的参数才有效，否则无意义参数说明：lPlayHandle的返回值playframer

44、ate返回的帧率返回值：成功返回TRUE，失败返回FALSE相关函数 :、典型应用： 与上一接口对应 ,获取当前的播放帧率 , 对单帧播放是无效 ,或获取 的为之前的播放帧率 ;25. CLIENT_API nChannelID,3.4 云台控制intBOOLBOOL CLIENT_PTZControl(LONG lLoginID,DWORD dwPTZCommand, DWORD dwStep,dwStop);函数说明：云台控制参数说明：lLoginID的返回值nChannelID通道号 dwPTZCommand 支持以下云台控制命令 typedef enum PTZ_ControlType

45、 PTZ_UP_CONTROL = 0,bEnd 1200192011520 1500 3.1.83.1.83.1.83.1.83.1.83.1.83.1.83.1.83.1.83.1.83.1.83.1.8 102410241024，1-"-"2-"/"BYTE byTimeFmt;#define DH_ALARM_UPLOAD此处定义如何处理一个消息0x00000001#defi ne DH_ALARM_RECORD0x00000002#defi ne DH_ALARM_PTZ0x00000004#defi ne DH_ALARM_MAIL0x000

46、00008#defi ne DH_ALARM_TOUR0x00000010#defi ne DH_ALARM_TIP0x00000020#defi ne DH_ALARM_OUT0x00000040#defi ne DH_MOTION_ROW12#defi ne DH_MOTION_COL16typedef struct消息处理方式，可以同时多种处理方式，包括* 0x00000001-网络：上传管理服务器* 0x00000002-录像：触发* 0x00000004-云台联动* 0x00000008-发送邮件* 0x00000010-设备本地报警轮巡* 0x00000020-设备提示使能* 0x

47、00000040-设备报警输出使能/*当前报警所支持的处理方式*/DWORDdwActio nM ask;/*触发动作，具体动作所需要的参数在各自的配置中体现，如报警录像长度，设置为10秒，可以在报警配置中设置*/DWORDdwActio nF lag;/*报警（录象）持续时间*/DWORDdwDuratio n;/*报警触发的输出通道，报警触发的输出，为1表示触发该输出*/BYTEbyRelAlarmOutDH_MAX_ALARMOUT_NUM;/*联动录象*/BYTEbyRecordCha nn elDH_MAX_VIDEO_IN_NUM;联动，1.转到预置点，2.巡航,3.轨迹,4.线扫

48、*/BYTE byPtzTypeDH_MAX_VIDEO_IN_NUM;/*调用的云台预置点序号/巡航组号/轨迹序号/线扫序号，各通道可不同设置*/BYTE byPtzNoDH_MAX_VIDEO_IN_NUM;DH_MSG_HANDLE;/*外部报警*/typedef struct/报警器类型，0 :常开，1 :常闭/报警使能BYTEbyAlarmType;BYTEbyAlarmE n;BYTEbyReserved2;DH_TSECT stSectDH_N_WEEKSDH_N_REC_TSECT;DH_MSG_HANDLE struHa ndle;/ 处理方式 DH_ALARMIN_CFG,

49、*LPDHDEV_ALARMIN_CFG;/* 动态检测报警 typedef structBYTEBYTE*/WORDBYTEDH_TSECTbyMotionEn;byReserved;wSenseLevel; / 灵敏度 byDetectedDH_MOTION_ROWDH_MOTION_COL;/ 检测区域，共 12*16 stSectDH_N_WEEKSDH_N_REC_TSECT;/ 动态检测报警使能块区域DH_MSG_HANDLE struHandle; / 处理方式 DH_MOTION_DETECT_CFG;/* 视频丢失报警typedef struct*/byAlarmEn;byR

50、eserved3; stSectDH_N_WEEKSDH_N_REC_TSECT;DH_MSG_HANDLE struHandle;BYTEBYTEDH_TSECTDH_VIDEO_LOST_CFG;图像遮挡报警/ 视频丢失报警使能/处理方式/* typedef struct*/使能 灵敏度 1-6byBlindEnable;byBlindLevel;byReserved2;stSectDH_N_WEEKSDH_N_REC_TSECT;DH_MSG_HANDLE struHandle; / 处理方式BYTEBYTEBYTEDH_TSECT/DH_BLIND_CFG;硬盘消息 （内部报警 ） *

51、/* typedef struct BYTEBYTEDH_TSECTDH_MSG_HANDLEBYTEBYTEDH_TSECTDH_MSG_HANDLEBYTEBYTEDH_TSECTDH_MSG_HANDLEbyNoDiskEn; byReserved_13; stNDSectDH_N_WEEKSDH_N_REC_TSECT; struHandle;/ 处理方式byLowCapEn;/ 硬盘低容量时报警byReserved_23; stLCSectDH_N_WEEKSDH_N_REC_TSECT; struLCHandle;/ 处理方式byDiskErrEn;/ 硬盘故障报警byReserv

52、ed_33; stEDSectDH_N_WEEKSDH_N_REC_TSECT; struEDHandle; / 处理方式/ 无硬盘时报警 DH_DISK_ALARM_CFG;/* 报警布防 */ typedef struct DWORD dwSize;DH_ALARMIN_CFGDH_MOTION_DETECT_CFG DH_VIDEO_LOST_CFG DH_BLIND_CFG DH_DISK_ALARM_CFG / 可能还有设备异常 DHDEV_ALARM_SCHEDULE;struAlarmInDH_MAX_ALARM_IN_NUM; struMotionDH_MAX_VIDEO_IN_NUM;