海康OCX控件接口说明(V2.3)

OCX 控件接口说明 控件接口说明 V2.3 版本 版本(20100611)
控件版本更新说明: 1. 版本号改为 2.3.9.1 2. 增加接口:BMPCapturePicV23、JPEGCapturePicV23、StartRecordV23 3. 支持第三方 IPC 的添加 20100115 更新: 1. 增加添加数字通道时获取第三方 IPC 协议的接口 2. 增加 GetServerIPByIPServer 接口通过 IP-SERVER 模式获取 IP 地址接口 20100405 更新: 1. GetServerInfo 接口中增加获取零通道个数的节点 2. 增加零通道相关接口,开始零通道预览、停止零通道预览、零通道预览画面翻 页 20100510 更新: 1. GetIPCConfig 和 SetDigitChannel 接口增加是否启用快速添加节点。用于 95NVR 2. 增加通过 SADP 获取在线 IPC 信息列表接口:GetIPCInfoBySadp 3. 增加修改 SADP 获取的在线 IPC 信息接口:SetIPCameraInfo

方法: 方法

1.注册 注册 1.1 注册
long Login(LPCTSTR lpServerIP, long lPort, LPCTSTR lpUserName, LPCTSTR lpPassword) 功能:注册用户到硬盘录像机 参数说明: lpServerIP:硬盘录像机的 IP 地址 lPort:硬盘录像机端口号 lpUserName:登陆的用户名 lpPassword:登陆的密码 返回值:lUserID 提供给其他接口使用。-1 表示注册失败。

1.2 设置 UserID
BOOL SetUserID(long lUserID)

功能:设置 UserID,如果注册成功,可以通过该接口传入 UserID. 参数说明: lUserID:要传入的 UserID 值 返回值:TRUE 表示成功,FALSE 表示失败。

2.注销 2.注销 2.1 注销
BOOL Logout() 功能:从硬盘录像机上注销某个用户 返回值:TRUE 表示成功,FALSE 表示失败。

2.2 释放 OCX
BOOL ClearOCX() 功能:停止一切操作,例如录像、预览等操作 返回值:TRUE 表示成功,FALSE 表示失败。

3.解析 3.解析 IP 地址 3.1 利用普通域名解析 IP 地址
BSTR GetServerIP(LPCTSTR lpURL) 功能:域名方式登陆时解析所连接硬盘录像机的 IP 参数说明: lpURL:域名地址 返回值:返回解析到的硬盘录像机的 IP 地址,返回空表示失败。

3.2 利用 IP-SERVER 模式获取 IP 地址 IPBSTR GetServerIPByIPServer (LPCTSTR lpDNSIP, LPCTSTR lpServerName, LPCTSTR lpSerialNumber) 功能:从 IP-Server 服务器上获取 IP 地址,序列号和设备名称不能同时为 空。 参数说明: lpDNSIP: DNS IP 地址 lpServerName: 设备名称 lpSerialNumber:序列号 返回值:返回解析到的硬盘录像机的 IP 地址,返回空表示失败

4.获取硬盘录像机的信息 获取硬盘录像机的信息
BSTR GetServerInfo() 功能:获取硬盘录像机的信息,注册成功后才有效 返回值:以 XML 形式记录硬盘录像机信息的一个字符串。 形式: <?xml version='1.0'?> <ServerInfo> < ChannelNumber> byChanNum </ChannelNumber >//模拟通道个 数 < DVRType> byDVRType </DVRType> //类型 < DiskNumber> byDiskNum </DiskNumber> //硬盘数 < SerialNumber> bySerialNumber </SerialNumber> //序列号 < AlarmInPortNum> byAlarmInPortNum </AlarmPortNum> //模拟通道报警输入个数 <AlarmOutPortNum> byAlarmOutPortNum </AlarmOutPortNum> //模拟通道报警输出个数 < StartChannel> byStartChan </StartChannel> //起始通道号 <AudioChanNum>byAudioChanNum</AudioChanNum> //语音通道个数 <MaxDigitChannelNum>byMaxDigitChannelNum</MaxDigitChannelNum> //最大数字通道插槽数 <ZeroChanNum>byZeroChanNum</ZeroChanNum>//零通道个数 </ServerInfo>

5.预览 5.预览 5.1 开始预览
BOOL StartRealPlay(long lChannelNum ,long lProtocolType, long lStreamType) 功能:开始预览(如果调用了 SetPlayWndType 接口,预览画面就按照设置 的比例显示。如果没有,当前预览通道是 HD720p 或者 HD900p 的分辨率,预览 画面自动变成 16:9 的比例;如果获取不到分辨率,预览画面大小就是当前控件 大小;其他分辨率时,预览画面为 4:3 的比例) 参数说明: lChannelNum:播放通道号, 0 – 代表通道 1,1 – 代表通道 2 lProtocolType:协议类型,0 – TCP, 1 - UDP lStreamType: 码流类型,0 表示主码流, 1 表示子码流 返回值:TRUE 表示成功,FALSE 表示失败。

5.2 停止预览
BOOL StopRealPlay() 功能:停止预览 返回值:TRUE 表示成功,FALSE 表示失败。

5.3 设置播放器帧缓冲区的个数
BOOL SetRealPlayBufNumber(long lBufNumber) 功能:设置播放器帧缓冲区的个数,在预览时才有效 参数说明: lBufNumber: 设置播放器帧缓冲区最大的帧数, 取值为 1-50。 缓冲区越大, 图象越流畅;缓冲区越小,实时性越好。若是复合流建议最 小值设置成 6。 返回值:TRUE 表示成功,FALSE 表示失败。

5.4 设置预览时丢 B 帧个数
BOOL RealPlayThrowBFrame(long lThrowBType) 功能:设置解码时丢弃 B 帧的个数,在预览时才有效 参数说明: lThrowBType:丢 B 帧个数,0 - 不丢,1 – 丢一个, 2 – 丢 2 个 返回值:TRUE 表示成功,FALSE 表示失败。

5.5 动态产生一个关键帧
BOOL MakeKeyFrame(long lChannelNum) 功能:网络预览时动态产生一个关键帧 参数说明: lChannelNum:通道号 返回值:TRUE 表示成功,FALSE 表示失败。

5.6 开始零通道预览
BOOL StartZeroRealPlay(long lZeroChannelNum, long lProtocolType, long lStreamType) 功能:开始零通道预览(画面比例为 4:3,暂时不支持子码流预览,零通 道不能控制云台,视频参数调节) 参数说明: lZeroChannelNum: 播放零通道号, 0 - 代表通道 1,1 - 代表通道 2 lProtocolType:协议类型,0 – TCP, 1 - UDP

lStreamType: 码流类型,0 表示主码流, 1 表示子码流 返回值:TRUE 表示成功,FALSE 表示失败。

5.7 停止零通道预览
BOOL StopZeroRealPlay() 功能:停止零通道预览 返回值:TRUE 表示成功,FALSE 表示失败。

5.7 零通道预览画面翻页
BOOL ZeroTurnOver(long lZeroChannelNum, BOOL bNextPreview) 功能:零通道预览画面翻页 参数说明: lZeroChannelNum 零通道号 bNextPreview 翻页, TRUE - 下一页, FALSE - 上一页 返回值:TRUE 表示成功,FALSE 表示失败。

6.抓图 6.抓图 6.1 抓 BMP 图
BOOL BMPCapturePicture(LPCTSTR lpSavePath, BOOL bShowSaveFile) 功能:抓 BMP 图,在预览时才有效 参数说明: lpSavePath:设置保存图片的路径。默认为"C:\OCXBMPCaptureFiles" , 图片保存在写入路径的 BMPCapture 文件夹中 bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹 返回值:TRUE 表示成功,FALSE 表示失败。

6.2 抓 JPEG 图
BOOL JPEGCapturePicture(long lChannelNum, short iPicSize, short iPicQuality, LPCTSTR lpSavePath, BOOL bShowSaveFile) 功能: JPEG 图, 抓 不需要预览。 当图像压缩分辨率为 VGA 时, 支持 0=CIF, 1=QCIF, 2=4CIF 抓图,当分辨率为 3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA,7=XVGA, 8=HD900p 仅支持当前分辨率的抓图 参数说明: lChannelNum:通道号。1 - 代表通道 1,2 – 代表通道 2 iPicSize : 分 辨 率 0=CIF, 1=QCIF, 2=4CIF 3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA

iPicQuality:图片质量 0-最好 1-较好 2-一般 lpSavePath:设置保存图片的路径。默认为"C:\OCXJPEGCaptureFiles"。图 片保存在写入路径的 JPEGCapture 文件夹中。 bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹 返回值:TRUE 表示成功,FALSE 表示失败。

6.3 按传入文件名抓 BMP 图
BOOL BMPCapturePicV23(LPCTSTR lpSavePath, BOOL bShowSaveFile, LPCTSTR lpSaveFileName) 功能:抓 BMP 图,在预览时才有效 参数说明: lpSavePath:设置保存图片的路径。默认为"C:\OCXBMPCaptureFiles" , 图片保存在写入路径的 BMPCapture 文件夹中 bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹 lpSaveFileName:保存文件的名称,默认为"IP_通道号_时间.bmp" 返回值:TRUE 表示成功,FALSE 表示失败。

6.4 按传入文件名抓 JPEG 图
BOOL JPEGCapturePicV23(long lChannelNum, short iPicSize, short iPicQuality, LPCTSTR lpSavePath, BOOL bShowSaveFile, LPCTSTR lpSaveFileName) 功能: JPEG 图, 抓 不需要预览。 当图像压缩分辨率为 VGA 时, 支持 0=CIF, 1=QCIF, 2=4CIF 抓图,当分辨率为 3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA,7=XVGA, 8=HD900p 仅支持当前分辨率的抓图 参数说明: lChannelNum:通道号。1 - 代表通道 1,2 – 代表通道 2 iPicSize : 分 辨 率 0=CIF, 1=QCIF, 2=4CIF 3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA iPicQuality:图片质量 0-最好 1-较好 2-一般 lpSavePath:设置保存图片的路径。默认为"C:\OCXJPEGCaptureFiles"。图 片保存在写入路径的 JPEGCapture 文件夹中。 bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹 lpSaveFileName: 保存图片的文件名,默认为"IP_通道号_时间.jpeg" 返回值:TRUE 表示成功,FALSE 表示失败。

7.对讲 7.对讲 7.1 开始对讲
BOOL StartTalk(long lTalkChanNum) 功能:开始对讲 参数说明: lTalkChanNum:对讲通道 返回值:TRUE 表示成功,FALSE 表示失败。

7.2 停止对讲
BOOL StopTalk() 功能:停止对讲 返回值:TRUE 表示成功,FALSE 表示失败。

7.3 设置语音对讲声音
BOOL SetVoiceComClientVolume(long lVolume) 功能:设置语音对讲PC端的音量 参数说明: lVolume:设置的音量,取值为 0 – 10 返回值:TRUE 表示成功,FALSE 表示失败。

8.云台控制 8.云台控制 8.1 云台控制开始
BOOL PTZCtrlStart(long lCtrlType,long lSpeed) 功能:云台开始控制命令,在预览时才有效 参数说明: lCtrlType:为云台动作:0 -- 云台向上,1 -- 云台向下,2 -- 云台向左,3 -- 云台向右, 4 -- 焦距缩进,5 -- 焦距拉远,6 -- 焦点近,7 -- 焦点远,8 -光圈小,9 -- 光圈大,10 – 自动, 11 – 灯光, 12 – 雨刷,13 - 云台左上, 14 - 云台右上, 15 - 云台左下, 16 - 云台右下。 lSpeed:云台速度,范围为 1 – 7。 如果值为 0,则按照无带速接口控制 云台。 返回值:TRUE 表示成功,FALSE 表示失败。

8.2 云台控制停止
BOOL PTZCtrlStop(long lCtrlType,long lSpeed) 功能:云台停止控制命令,在预览时才有效 参数说明: lCtrlType: 为云台动作:0 -- 云台向上,1 -- 云台向下,2 -- 云台向左, 3 -- 云台向右, 4 -- 焦距缩进,5 -- 焦距拉远,6 -- 焦点近,7 -- 焦点远,8 -光圈小, -- 光圈大, 10 – 自动, 11 – 灯光, 12 – 雨刷, - 云台左上, 14 9 13 - 云台右上, 15 - 云台左下, 16 - 云台右下。 lSpeed:云台速度,范围为 1 – 7。 如果值为 0,则按照无带速接口控制 云台。 返回值:TRUE 表示成功,FALSE 表示失败。

8.3 设置预置点
BOOL PTZCtrlSetPreset(long lPresetNumber) 功能:设置云台预置位,需要预览 参数说明: lPresetNumber:云台预置位号,最多支持 256 个。 返回值:TRUE 表示成功,FALSE 表示失败。

8.4 调用预置点
BOOL PTZCtrlGotoPreset(long lPresetNumber) 功能:调用云台预置位,需要预览 参数说明: lPresetNumber:云台预置位号,最多支持 256 个。 返回值:TRUE 表示成功,FALSE 表示失败。

9.视频参数 9.视频参数 9.1 获取视频参数
BSTR GetVideoEffect() 功能:获取视频参数,需要预览 返回值:以 XML 形式记录视频参数的一个字符串,返回空表示失败 形式: <?xml version='1.0'?> <VideoEffect> <Bright>byBright</Bright> //亮度 ( 取值为 1 – 10 ) <Contrast>byContrast</Contrast> //对比度 ( 取值为 1- 10 )

<Saturation>bySaturation</Saturation> <Hue>byHue</Hue> </VideoEffect>

//饱和度 ( 取值为 1- 10 ) //色调 ( 取值为 1 - 10 )

9.2 设置视频参数
BOOL SetVideoEffect(long lBrightValue, long lContrastValue, lSaturationValue, long lHueValue) 功能:设置视频参数,需要预览 参数说明: lBrightValue:亮度 ( 取值为 1 – 10 ) lContrastValue: 对比度 ( 取值为 1- 10 ) lSaturationValue:饱和度 ( 取值为 1- 10 ) lHueValue: 色调 ( 取值为 1 - 10 ) 返回值:TRUE 表示成功,FALSE 表示失败。 long

10.声音控制 10.声音控制 10.1 设置声音模式
BOOL SetAudioMode(long lSoundMode) 功能:设置声音播放模式,需要在预览前设置 参数说明: lSoundMode: 打开声音模式。 1 – 独占模式 , 2 – 共享模式 返回值:TRUE 表示成功,FALSE 表示失败。

10.2 10.2 打开声音
BOOL OpenSound(long lSoundMode) 功能:打开声音,需要预览 参数说明: lSoundMode: 打开声音模式。 1 – 独占模式 , 2 – 共享模式 返回值:TRUE 表示成功,FALSE 表示失败。

10.3 10.3 关闭声音
BOOL CloseSound(long lSoundMode) 功能:关闭声音,需要预览 参数说明: lSoundMode: 关闭声音模式。 1 – 独占模式, 2 – 共享模式 返回值:TRUE 表示成功,FALSE 表示失败。

10.4 10.4 调节音量
BOOL SetVolume(long lVolume) 功能:调节音量 参数说明: lVolume:设置的音量,取值为 0 – 9。 返回值:TRUE 表示成功,FALSE 表示失败。

11.录像 11.录像 11.1 开始录像
BOOL StartRecord(LPCTSTR lpSavePath) 功能:开始录像,在预览时才有效 参数说明: 。录 lpSavePath:设置保存录像文件的路径。默认为“C:\OCXRecordFiles” 像文件保存在写入路径的当前日期下。例如:C:\OCXRecordFiles\2009-07-13 返回值:TRUE 表示成功,FALSE 表示失败。

11.2 停止录像
BOOL StopRecord(BOOL bShowSaveFile) 功能:停止录像, 在预览时才有效 参数说明: bShowSaveFile 停止录像后是否弹出保存录像文件的文件夹 返回值:TRUE 表示成功,FALSE 表示失败。

11.3 开始远程录像 1.3
BOOL StartRemoteRecord(long lChannelNum) 功能:开始远程录像 参数说明: lChannelNum:录像通道号 ,0 – 代表通道 1 返回值:TRUE 表示成功,FALSE 表示失败。

11.4 11.4 停止远程录像
BOOL StopRemoteRecord(long lChannelNum) 功能:停止远程录像 参数说明:

lChannelNum:录像通道号,0 – 代表通道 1 返回值:TRUE 表示成功,FALSE 表示失败。

11.5 按传入文件名开始录像
BOOL StartRecordV23(LPCTSTR lpSavePath, LPCTSTR lpSaveFileName) 功能:开始录像,在预览时才有效 参数说明: 。录 lpSavePath:设置保存录像文件的路径。默认为“C:\OCXRecordFiles” 像文件保存在写入路径的当前日期下。例如:C:\OCXRecordFiles\2009-07-13 lpSaveFileName: 保存图片的文件名,默认为"IP_通道号_时间.mp4" 返回值:TRUE 表示成功,FALSE 表示失败。

12.远程回放 12.远程回放 12.1 获取录像文件
BSTR SearchRemoteRecordFile(long lChannelNum, long lFileType, LPCTSTR lpStartTime, LPCTSTR lpStopTime, BOOL bATMType , BOOL bNeedCardNum, LPCTSTR lpCardNumber) 功能:获取录像文件 参数说明: lChannelNum:通道号,0 – 代表通道 1,1- 代表通道 2 lFileType:查找文件的类型。如果不是 ATM 机:bATMTyp 为 false, 0 – 全部, 1 – 定时录像, 2 – 移动侦测, 3 – 报警触发, 4 – 报警|动测, 5 – 报 警&动测,6 – 命令触发, 7 – 手动触发。 如果是 ATM 机:bATMType 为 true, 0 – 全部, 1 – 定时录像, 2 – 移动侦测, 3 – 接近报警, 4 – 出钞报警, 5 – 进钞报警, 6 – 命令触发, 7 – 手动触发, 8 – 震动报警。 lpStartTime:开始时间,格式为:2007-3-8 2:30:50。不能为空 lpStopTime:结束时间,格式为:2007-3-9 10:30:47。不能为空 bATMType:是否按卡号查询,TRUE 表示 是,FALSE 表示 不是 bNeedCardNum:是否需要卡号信息,TRUE 表示是,FALSE 表示不是 lpCardNumber:卡号信息 返回值: XML 形式记录所查询的远程录像文件的一个字符串。 以 如果是 “null” ,代表没有录像文件。如果 是空表示失败,失败原因:lUserID 小于 0, 通道号不存在,开始时间大于结束时间,获取文件列表失败,由于服务器忙,或网 络故障,获取文件列表异常终止。 形式: <?xml version='1.0'?> <SearchRemoteRecordFile> <File>

<Index>dwIndex</Index> <FileName> sFileName </FileName> //录像文件名称 <StartTime> struStartTime </StartTime> //录像文件开始时间 <StopTime> struStopTime </StopTime> //录像文件结束时间 <FileSize> dwFileSize </ FileSize > //录像文件的大小 </File> <File> <Index>dwIndex</Index> <FileName> sFileName </FileName> //录像文件名称 <StartTime> struStartTime </StartTime> //录像文件开始时间 <StopTime> struStopTime </StopTime> //录像文件结束时间 <FileSize> dwFileSize </ FileSize > //录像文件的大小 </File> … … //一样的 N 条记录 </ SearchRemoteRecordFile >

12.2 按文件名回放
BOOL PlayBackByName(LPCTSTR lpFileName) 功能:按文件名回放录像文件,如果调用了 SetPlayWndType 接口,就按 设置的比例进行显示,否则就按主码流分辨率进行对应的比例显示。 参数说明: lpFileName:回放的文件名 返回值:- TRUE 表示成功,FALSE 表示失败。

12.3 按时间回放
BOOL PlayBackByTime(long lChannelNum, LPCTSTR lpStartTime, LPCTSTR lpStopTime) 功能:按时间回放录像文件,如果调用了 SetPlayWndType 接口,就按设 置的比例进行显示,否则就按主码流分辨率进行对应的比例显示。 参数说明: lChannelNum:通道号,0 – 代表通道 1, 1 – 代表通道 2 lpStartTime:开始时间,格式为:2007-3-8 2:30:50。不能为空 lpStopTime:结束时间,格式为:2007-3-8 2:30:50。不能为空 返回值:TRUE 表示成功,FALSE 表示失败。失败原因:lUserID 小于 0, 通道号不存在,开始时间大于结束时间。

12.4 停止回放
BOOL StopPlayBack()

功能:停止回放 返回值:TRUE 表示成功,FALSE 表示失败。

12.5 播放控制
BOOL PlayBackControl(long lPlayBackControlType, long lInValue) 功能:播放控制 参数说明: 控制命令: 1-开始播放,2-停止播放, 3-暂停播放, lPlayBackControlType: 4-恢复播放,5-快放,6-慢放,7-正常速度,8-单帧放,9-打开声音,10-关闭声 音,11-调节声音,12-改变文件回放的进度, 20-丢B帧。 lInValue:输入参数,有些控制命令需要用到。 返回值:TRUE 表示成功,FALSE 表示失败。

12.6 保存回放文件片段
BOOL PlayBackSaveFile(LPCTSTR lpSaveFileName) 功能:回放时,保存回放的片段 参数说明: lpSaveFileName:保存的文件名称。 返回值:TRUE 表示成功,FALSE 表示失败。

12.7 停止保存回放文件片段
BOOL StopSaveFile() 功能:回放时,停止保存回放的片段 返回值:TRUE 表示成功,FALSE 表示失败。

12.8 获取回放保存片段的文件名
BSTR GetPlaybackSaveFileName() 功能:获取回放时,保存片段的文件名。 返回值:返回保存片段的文件名。

12.9 获取回放 OSD 显示时间
BSTR GetPlaybackOSDTime() 功能:获取回放 OSD 显示时间。 返回值:显示标准时间显示,空表示失败。

12.10 12.10 回放抓图
BOOL PlayBackCapture(LPCTSTR lpSavePath , BOOL bShowSaveFile) 功能:回放时,停止保存回放的片段。 参数说明: lpSavePath:保存图片的文件名,文件名的长度小于等于100 字节。路径 默认为“C:\OCXSaveAllFiles\” 。图片保存在写入路径的PlaybackCapture文件 夹中。 bShowSaveFile: 回放抓图成功后是否弹出保存图片文件的文件夹 返回值:TRUE 表示成功,FALSE 表示失败。

12.11 12.11 按文件名下载
BOOL DownLoadByFileName(LPCTSTR lpRecordFileName, LPCTSTR lpDownLoadPath) 功能:根据文件名下载文件,生成的文件名格式为:IP 地址_通道号_当 前时间.mp4 参数说明: lpRecordFileName:要下载的文件名。 lpDownLoadPath: 下载录像的路径, 路径默认为 “C:\OCXDownloadFiles” 。 录像文件保存在写入路径的当前日期下。例如:C:\OCXDownloadFiles\2009-07-13. 返回值:TRUE 表示成功,FALSE 表示失败。

BOOL DownLoadByFileNameV23(LPCTSTR lpRecordFileName, LPCTSTR lpFileStartTime, LPCTSTR lpDownLoadPath) 功能:根据文件名下载文件,生成的文件名格式为:IP 地址_端口号_通道 号_文件起始时间_随机时间.mp4 参数说明: lpRecordFileName:要下载的文件名 lpFileStartTime: 要下载文件的起始时间 lpDownLoadPath: 下载录像的路径, 路径默认为 “C:\OCXDownloadFiles” 。 录 像 文 件 保 存 在 写 入 路 径 的 文 件 起 始 时 间 下 。 例 如 : C:\OCXDownloadFiles\2009-07-13。 返回值:TRUE 表示成功,FALSE 表示失败。

12.12 12.12 按时间下载
BOOL DownLoadByTime(long lChannelNum, LPCTSTR lpStartTime, LPCTSTR lpStopTime, LPCTSTR lpDownLoadPath)

功能:按时间下载, 生成的文件格式为:IP 地址_通道号_当前时间.mp4 参数说明: lChannelNum:回放通道号,0 - 代表通道 1, 1 – 代表 通道 2. lpStartTime:开始时间,格式为:2007-3-8 2:30:50。不能为空 lpStopTime:结束时间,格式为:2007-3-9 10:30:47 。不能为空 lpDownLoadPath: 下载录像的路径, 路径默认为 “C:\OCXDownloadFiles” 。 录像文件保存在写入路径的当前日期下。例如:C:\OCXDownloadFiles\2009-07-13 返回值:TRUE 表示成功,FALSE 表示失败。失败原因:lUserID 小于 0, 通道号不存在,开始时间大于结束时间,保存路径错,下载失败。

BOOL DownLoadByTimeV23 (long lChannelNum, LPCTSTR lpStartTime, LPCTSTR lpStopTime, LPCTSTR lpDownLoadPath) 功能:按时间下载, 生成的文件格式为:IP 地址_端口号_通道号_文件起 始时间_随机时间.mp4 参数说明: lChannelNum:回放通道号,0 - 代表通道 1, 1 – 代表 通道 2. lpStartTime:开始时间,格式为:2007-3-8 2:30:50。不能为空 lpStopTime:结束时间,格式为:2007-3-9 10:30:47 。不能为空 下载录像的路径, 路径默认为 “C:\OCXDownloadFiles” 。 lpDownLoadPath: 录 像 文 件 保 存 在 写 入 路 径 的 文 件 起 始 时 间 下 。 例 如 : C:\OCXDownloadFiles\2009-07-13。 返回值:TRUE 表示成功,FALSE 表示失败。失败原因:lUserID 小于 0, 通道号不存在,开始时间大于结束时间,保存路径错,下载失败。

12.13 12.13 停止下载
BOOL StopDownLoadFile() 功能:停止下载 参数说明: 返回值:TRUE 表示成功,FALSE 表示失败。

12.14 12.14 获取下载进度
long GetDownloadPos() 功能:获取下载进度 返回值:-1 表示失败,0 – 100 表示下载进度,100 表示下载结束, 大 于 100 表示由于网络原因,下载异常终止。

12.15 12.15 获取文件回放进度
long GetPlayBackPos() 功能:获取文件回放进度。 返回值:-1 表示失败,0-100 表示回放进度,100 表示回放结束,大于 100 表示由于网络原因,回放异常终止。

12.16 12.16 获取当前已经播放的时间
long GetPlayBackTime () 功能:获取当前已经播放的时间 返回值:-1 表示失败,其他值表示时间,取小时、分钟、秒,分别除 60 取余数。

12.17 获取当前已经播放的帧数 12.17
long GetPlayBackFrame () 功能:获取当前已经播放的帧数。 返回值:-1 表示失败,其他值表示成功。

12.18 获取当前播放文件的总帧数 12.18
long GetPlayBackTotalFrame () 功能:获取当前播放文件的总帧数 返回值:-1 表示失败,其他值表示成功。

12.19 获取当前播放文件的总时间 12.19
long GetPlayBackTotalTime () 功能:获取当前播放文件的总时间。 返回值:-1 表示失败,其他值表示时间,取小时、分钟、秒,分别除 60 取余数。

12.20 12.20 刷新显示
BOOL PlayBackRefresh() 功能: 刷新显示,暂停和单帧放时保留图像 返回值: -1 表示失败,其他值表示成功。

13.远程配置 13.远程配置 13.1 弹出远程配置窗口
BOOL SetRemoteConfig(LPCTSTR lpUserName, long lLanguageType, BOOL bShowIPCCfg, long lBkColorType, long lColorType) 功能:弹出远程配置窗口 参数说明: lpUserName: 登陆设备的用户名 lLanguageType: 语言类型,0 - 简体中文, 1- 英文 bShowIPCCfg: 是否显示 IPC 配置界面 lBkColorType: 背景颜色类别 字体颜色类别 lColorType : 返回值:TRUE 表示成功,FALSE 表示失败。

13.2 设置远程配置显示项
BOOL SetRemCfgNode(long lMainNode, long lSubNode, long bEnable) 功能:设置远程配置的配置项(在 SetRemoteConfig 前使用) 参数说明: lMainNode: 配置树的主节点索引值 (0xff -- 全部) lSubNode: 配置树的子节点索引值 (0xff -- 全部) bEnable: 启用标识符 返回值:TRUE 表示成功,FALSE 表示失败。

14.远程日志 14.远程日志
BSTR SearchRemoteLogInfo(long lSelectMode, long lMajorType, long lMinorType, LPCTSTR lpStartTime, LPCTSTR lpStopTime, BOOL bSearchSmart) 功能:获取硬盘录像机日志 参数说明: lSelectMode:查询方式。0 – 全部, 1 – 按类型, 2 – 按时间, 3 – 按 时间和类型 lMajorType:主类型。0 – 全部,1 - 报警, 2 - 异常, 3 - 操作 , 4 附加信息 lMinorType:次类型。0 – 全部,(其他选项根据主类型不同而不同) lpStartTime:开始时间,格式为:2007-3-8 2:30:50。不能为空 lpStopTime:结束时间,格式为:2007-3-9 10:30:47。不能为空 bSearchSmart: 是否查询Smart信息。 为TRUE时, lSelectMode, lMajorType, lMinorType无效. 返回值:以 XML 形式记录所查询的远程日志的一个字符串。如果是

“null” ,代表没有日志信息。如果是空表示失败,失败原因:lUserID 小于 0, 通道号不存在,开始时间大于结束时间,由于服务器忙,或网络故障,搜索日志异 常终止 形式: <?xml version='1.0'?> <SearchLog> <LogInfo> <Index>dwIndex</Index> //序号 <LogTime> strLogTime </LogTime> //日志时间 <AlarmInPort>dwAlarmInPort</AlarmInPort> //报警输入号 <AlarmOutPort>dwAlarmOutPort</AlarmOutPort> //报警输出号 < HardDiskNumber>dwHardDiskNumber</HardDiskNumber> //硬盘号 <ChannelNumber>dwChannelNumber</ChannelNumber> //通道号,-1代表全部,0代表没有 <MajorType> dwMajorType </MajorType> //主类型 <MinorType> dwMinorType </MinorType> //次类型 <NetUser>strNetUser</NetUser> //网络操作用户 <NetUserIP>strNetUserIP</NetUserIP> //远程操作 IP 地址 <LocalUser>strLocalUser</LocalUser> //本地操作用户 <LogInfomation>strLogInfomation</LogInfomation> //日志详细信息描述 </LogInfo> <LogInfo> <Index>dwIndex</Index> <LogTime> strLogTime </LogTime> //日志时间 <AlarmInPort>dwAlarmInPort</AlarmInPort> //报警输入口 <AlarmOutPort>dwAlarmOutPort</AlarmOutPort> //报警输出口 < HardDiskNumber>dwHardDiskNumber</HardDiskNumber> //硬盘号 <ChannelNumber>dwChannelNumber</ChannelNumber> //通道号 <MajorType> dwMajorType </MajorType> //主类型 <MinorType> dwMinorType </MinorType> //次类型 <NetUserIP>strNetUserIP</NetUserIP> //远程操作 IP 地址 <LocalUser>strLocalUser</LocalUser> //本地操作用户 <LogInfomation>strLogInfomation</LogInfomation> //日志详细信息描述 </LogInfo> … … //一样的好多条记录 </SearchLog>

注: dwAlarmInPort 为 0, 当 dwAlarmOutPort 为 0, dwHardDiskNumber 为 0,ChannelNumber 为 0,strLocalUser 为空,strNetUser 为空,xml 文档中返回的 对应值是“null” 。 dwMajorType 值:1 - 报警, 2 - 异常, 3 - 操作。 当 dwMajorType 为 1 时,dwMinorType 值: 1 - 报警输入,2 - 报警输出,3 - 移 动侦测报警开始,4 - 移动侦测报警结束,5 - 遮挡报警开始,6 - 遮挡报警结束。 当 dwMajorType 为 2 时,dwMinorType 值: 1 - 信号丢失,2 - 非法访问,3 - 硬 盘满,4 - 硬盘错误,5 - MODEM 掉线,6 - IP 地址冲突,7 - 网线断, 8 - 录 。 像失败, 9 - IPC 未连接上, 10 - 视频输入异常(只针对模拟通道) 当 dwMajorType 为 3 时,dwMinorType 值: 1 – 开机,2 – 关机,3 – 非法关机, 4 – 本地重启设备, 5 - 本地登陆, – 本地注销登陆, 7 - 本地配置参数, - 本 6 8 地按文件回放, 9 - 本地按时间回放, 10 - 本地开始录像, 11 - 本地停止录像, 12 本地云台控制, 13 - 本地预览, 14 - 本地修改时间, 15 - 本地升级, 16 - 本地导出 录象文件,17 - 本地格式化硬盘, 18 - 导出本地配置文件, 19 - 导入本地配置 文件,20 - 本地备份文件, 21 - 本地锁定录像文件,22 - 本地解锁录像文件,23 - 本地手动清除和触发报警, 24 - 本地添加 IPC, 25 - 本地删除 IPC, 26 - 本 地设置 IPC, 27 - 远程登录, 28 - 远程注销登陆, 29 - 远程开始录像, 30 - 远程停 止录像, 31 - 开始透明传输, 32 - 停止透明传输, 33 - 远程获得参数, 34 - 远程配 置参数, 35 - 远程获得状态, 36 - 远程布防, 37 - 远程撤防, 38 - 远程重启, 39 开始语音对讲, 40 - 停止语音对讲, 41 - 远程升级, 42 - 远程按文件回放, 43 远程按时间回放, 44 - 远程云台控制, 45 - 远程格式化硬盘, 46 - 远程关机, 47 - 远程锁定文件, 48 - 远程解锁文件, 49 - 远程导出配置文件, 50 - 远程 导入配置文件, 51 - 远程导出录象文件, 52 - 远程手动清除和触发报警, 53 远程添加 IPC, 54 - 远程删除 IPC, 55 - 远程设置 IPC。 当 dwMajorType 为 4 时,dwMinorType 值:1 - 硬盘信息, 2 - SMART 信息, 3 - 开始录像, 4 - 停止录像, 5 - 超期录像删除。

15.重新启动 15.重新启动
BOOL RebootServer() 功能:重新启动硬盘录像机 返回值:TRUE 表示成功,FALSE 表示失败。

16.恢复默认值 16.恢复默认值
BOOL RestoreConfig() 功能:恢复默认值 返回值:TRUE 表示成功,FALSE 表示失败。

17.报警输出 17.报警输出 17.1 控制报警输出
BOOL ControlAlarmOut(long lAlarmOutNum, long lAlarmOutStatic) 功能:控制报警输出 参数说明: lAlarmOutNum:报警输出口号 lAlarmOutStatic:报警输出状态, 0 – 停止输出, 1 – 输出 返回值:TRUE 表示成功,FALSE 表示失败。

17.2 获取报警输出通道状态 17.2
long GetAlarmOutStatus(long lAlarmOutNum) 功能:获取报警输出通道状态 参数说明: lAlarmOutNum:报警输出口号 返回值:0 表示无效, 1 表示有效, -1 表示失败。

18.获取设备状态 18.获取设备状态
BSTR GetServerWorkState() 功能:获取硬盘录像机工作状态 参数说明: 返回值:以 XML 形式记录工作状态的一个字符串。如果是空表示失败. 形式: <?xml version='1.0'?> <ServerWorkState> <ServerStatic>dwServerStatic< /ServerStatic> //设备的状态 <LocalShowStatic> dwLocalShowStatic < /LocalShowStatic> //本地显示状态 <ChannelState> <Record> byRecord < /Record> //是否在录像 <Signal> bySignal < /Signal> //连接的信号状态 <HardWareStatic>byHardWareStatic</HardWareStatic> //通道硬件状态 <BitRate> byBitRate </BitRate> //实际码率 <LinkNum> byLingkNum </LinkNum> //连接的个数 … … </ChannelState>

<HardDiskState> <Volume>byVolume</Volume> //硬盘容量 <FreeSpace>byFreeSpace< /FreeSpace> //硬盘的剩余空间 <HardDiskStatic>byHardDiskStatic</HardDiskStatic> //硬盘的状态 …. … </HardDiskState> </ServerWorkState> 注:dwServerStatic 的值:0 - "正常",1 - "CPU 占用率超过 85%", 2 - "硬件 错误" dwLocalShowStatic 的值:0 - "正常",1 - "不正常" byRecord 的值:0 - "不录像",1 - "录像" bySignal 的值:0 - "正常", 1 - "信号丢失" byHardWareStatic 的值:0 - "正常",1 - "异常" byHardDiskStatic 的值:0 - "活动", 1 - "休眠", 2 - "不正常"

19.获取设备通道名称 19.获取设备通道名称
BSTR GetChannelName(long lChannelNum) 功能:获取硬盘录像机通道名称 参数说明: lChannelNum:通道号,0 - 代表通道 1, 1 – 代表 通道 2 返回值:返回通道名称,如果为空表示失败。

20.获取错误类型 20.获取错误类型
long GetLastError() 功能:获取操作错误类型 返回值: 0 - 没有错误,1 - 用户名密码错误,2 - 权限不足,3 - 没有初 始化,4 - 通道号错误,5 - 连接到 DVR 的客户端个数超过最大,6 - 版本不 匹配,7 - 连接服务器失败,8 - 向服务器发送失败,9 - 从服务器接收数据 失败,10 - 从服务器接收数据超时,11 - 传送的数据有误,12 - 调用次序错 误,13 - 无此权限,14 - DVR 命令执行超时,15 - 串口号错误,16 - 报警端 口错误,17 - 参数错误,18 - 服务器通道处于错误状态,19 - 没有硬盘,20 - 硬盘号错误,21 - 服务器硬盘满,22 - 服务器硬盘出错,23 - 服务器不支 持,24 - 服务器忙,25 - 服务器修改不成功,26 - 密码输入格式不正确,27 - 硬盘正在格式化,不能启动操作,28 - DVR 资源不足,29 - DVR 操作失 败,30 - 打开 PC 声音失败,31 - 服务器语音对讲被占用,32 - 时间输入不 正确,33 - 回放时服务器没有指定的文件,34 - 创建文件出错, - 打开文 35 件出错, - 上次的操作还没有完成, - 获取当前播放的时间出错, - 播 36 37 38 41 42 放出错,39 - 文件格式不正确,40 - 路径错误, - 资源分配错误, - 声 卡模式错误, - 缓冲区太小, - 创建 SOCKET 出错, - 设置 SOCKET 43 44 45

出错, - 个数达到最大, - 用户不存在, - 写 FLASH 出错, - DVR 46 47 48 49 升级失败,50 - 解码卡已经初始化过,51 - 播放器中错误,52 - 用户数达到 最大,53 - 获得客户端的 IP 地址或物理地址失败,54 - 该通道没有编码, 55 - IP 地址不匹配,56 - MAC 地址不匹配,57 - 升级文件语言不匹配,58 播放器路数达到最大, 59 - 备份设备中没有足够空间进行备份, 60 - 没有找 到指定的备份设备,61 - 图像素位数不符,限 24 色, 62 - 图片高*宽超限, 限 128*256, 63 - 图片大小超限, 100K, 64 - 载入当前目录下 Player Sdk 限 出错, 65 - 找不到 Player Sdk 中某个函数入口, 66 - 载入当前目录下 DSsdk 出错, 67 - 找不到 DsSdk 中某个函数入口,68 - 调用 DsSdk.dll 中某个函数 失败, 69 - 声卡被独占, 70 - 加入多播组失败, 71 - 建立日志文件目录 失败,72 - 绑定套接字失败, 73 - socket 连接中断,此错误通常是由于连接 中断或目的地不可达, 74 - 注销时用户 ID 正在进行某操作, - 监听失败, 75 76 - 程序异常, 77 - 写文件失败, 78 - 禁止格式化只读硬盘, 79 - 用户 配置结构中存在相同的用户名, 80 - 导入参数时设备型号不匹配,81 - 导 入参数时语音不匹配, 82 - 导入参数时软件版本不匹配, 83 - 预览时外接 IP 通道不在线, 84 - 加载高清 IPC 通讯库 StreamTransClient.dll 失败, 85 加载转码库失败。 - 超出最大的 ip 接入通道数, 90 - 设备正在备份, 91 - 通 86 道不支持该操作。

21.获取设备名称 21.获取设备名称
BSTR GetServerName() 功能:获取硬盘录像机名称 返回值:硬盘录像机名称,如果为空表示失败。

22.设备校时 22.设备校时
BOOL CheckTime() 功能:对硬盘录像机校时,时间为当前 PC 的时间 返回值:TRUE 表示成功,FALSE 表示失败。

BOOL SetServerTime(LPCTSTR lpServerTime) 功能:对硬盘录像机校时,时间为输入的时间 参数说明: lpServerTime:设置时间,格式为:2009-05-18 12:00:00 返回值:TRUE 表示成功,FALSE 表示失败。

23.远程配置文件 23.1 获取远程配置文件
BOOL GetRemoteConfigFile(LPCTSTR lpFilePath) 功能:获取远程配置文件 参数说明: lpFilePath:保存的文件 返回值:TRUE 表示成功,FALSE 表示失败。

23.2 设置远程配置文件
BOOL SetRemoteConfigFile(LPCTSTR lpFilePath) 功能:设置远程配置文件 参数说明: lpFilePath:设置的文件 返回值:TRUE 表示成功,FALSE 表示失败。

24.获取通道的分辨率 获取通道的分辨率
long GetChannelResolution(long lChannelNum, long lStreamType) 功能:获取通道的分辨率 参数说明: lChannelNum:通道号, 0 - 代表通道 1, 1 – 代表 通道 2 lStreamType:码流类型 0 – 主码流, 1 – 子码流 返回值:返回对应通道的分辨率, 0 - DCIF, 1 - CIF, 2 - QCIF, 3 - 4CIF, 4 2CIF, 16 - VGA(640*480), 17 - UXGA(1600*1200), 18 - SVGA(800*600), 19 HD720p(1280*720), 20 - XVGA, 21 - HD900p

25.IP 通道配置 25.1 获取 IP 通道配置
BOOL GetIPParaCfg() 功能:获取 IP 通道配置,在 GetIPCConfig()前使用 返回值:TRUE 表示成功,FALSE 表示失败

25.2 获取 IP 通道配置信息
BSTR GetIPCConfig() 功能:获取 IP 通道配置信息。(配合 GetIPParaCfg 一起使用) 返回值:以 XML 形式返回获取到的 IPC 配置信息 形式: <?xml version='1.0'?> <IPCCFG> <ANALOGCHAN> <AnalogChannelEnable> </AnalogChannelEnable>//是否启用 </ANALOGCHAN> <ANALOGCHAN> <AnalogChannelEnable> </AnalogChannelEnable>//是否启用
……… </ANALOGCHAN> <DIGITCHAN> <DigitChanNo> </DigitChanNo> <DeviceID> </DeviceID> <DigitServerEnable> </DigitServerEnable> <DigitChanEnable> </DigitChanEnable> <DeviceIP> </DeviceIP> <DeviceUserName> </DeviceUserName> <DeviceUserPsw> </DeviceUserPsw> <DevicePort> </DevicePort> <DeviceChannel> </DeviceChannel> <DeviceDomain> </DeiveDomain> <IPCType> </IPCType> <QuickAddEnable> </QuickAddEnable> </DIGITCHAN> <DIGITCHAN> <DigitChanNo> </DigitChanNo> <DeviceID> </DeviceID> <DigitServerEnable> </DigitServerEnable> <DigitChanEnable> </DigitChanEnable> <DeviceIP> </DeviceIP> <DeviceUserName> </DeviceUserName> <DeviceUserPsw> </DeviceUserPsw> <DevicePort> </DevicePort> <DeviceChannel> </DeviceChannel> <DeviceDomain> </DeiveDomain> <IPCType> </IPCType> <QuickAddEnable> </QuickAddEnable> </DIGITCHAN> //根据模拟通道数返回同样结构的数量

//数字通道号 //设备 ID 不启用时为 0 //设备是否启用 //通道是否在线 //设备 IP //登陆设备用户名 //登陆设备密码 //端口号 //设备通道号 //设备域名 //第三方 IPC 类型 //是否快速添加

//数字通道号 //设备 ID 不启用时为 0 //设备是否启用 //通道是否在线 //设备 IP //登陆设备用户名 //登陆设备密码 //端口号 //设备通道号 //设备域名 //第三方 IPC 类型 //是否快速添加

</IPCCFG >

25.3 设置模拟通道配置
BOOL SetAnalogChannel(LPCTSTR lpAnalogChanXML) 功能:设置模拟通道配置 参数说明: lpAnalogChanXML:模拟通道是否启用组成的 XML 文件 返回值:TRUE 表示成功,FALSE 表示失败 形式: <?xml version='1.0'?> <ANALOGCHAN> <AnalogChannelEnable> </AnalogChannelEnable> //是否启用模拟通道 <AnalogChannelEnable> </AnalogChannelEnable> ………….. //根据模拟通道数返回同样结构的数量 </ANALOGCHAN>

25.4 设置数字通道配置
BOOL SetDigitChannel(LPCTSTR lpDigitChanXML) 功能:设置数字通道配置 参数说明: lpDigitChanXML:数字通道配置信息组成的 XML 文件 返回值:TRUE 表示成功,FALSE 表示失败 形式: <?xml version='1.0'?> <DIGITCHANCFG> <DIGITCHAN> <DigitChanNo> </DigitChanNo> //数字通道号 <DeviceID> </DeviceID> //设备 ID <DigitServerEnable> </DigitServerEnable>//设备是否启用 <DigitChanEnable> </DigitChanEnable> //通道是否启用 <DeviceIP> </DeviceIP> //设备 IP <DeviceUserName> </DeviceUserName>//登陆设备用户名 <DeviceUserPsw> </DeviceUserPsw> //登陆设备密码 <DevicePort> </DevicePort> //端口号 <DeviceChannel> </DeviceChannel> //设备通道号 <DeviceDomain> </DeviceDomain> //设备域名
<IPCType> </IPCType> <QuickAddEnable> </QuickAddEnable> //第三方 IPC 类型 //是否快速添加

</DIGITCHAN > </ DIGITCHANCFG >

25. 25.5 获取第三方 IPC 协议类型
BSTR GetIPCProtocolPara () 功能:获取支持第三方 IPC 协议参数信息 返回值: XML 形式记录硬盘录像机支持的第三方 IPC 协议信息的 以 一个字符串 形式: <?xml version='1.0'?> < IPCPROTOCOLINFO >
<IPCProtocolCount> </IPCProtocolCount> //有效 IPC 协议数目 <IPCPROTOCOLCFG> <IPCProtocolType> </IPCProtocolType> //IPC 协议类型值 <IPCProtocolDescribe> </IPCProtocolDescribe> //IPC 协议的描述 </IPCPROTOCOLCFG> < IPCPROTOCOLCFG> <IPCProtocolType> </IPCProtocolType> // IPC 协议类型值 <IPCProtocolDescribe> </IPCProtocolDescribe> // IPC 协议的描述 </ IPCPROTOCOLCFG> …………… //根据 IPC 协议总数返回同样的数量 </ IPCPROTOCOLINFO>

25. 获取在线 25.6 通过 SADP 获取在线 IPC 信息列表
BSTR GetIPCInfoBySadp () 功能:通过 SADP 获取在线 IPC 参数信息 返回值: XML 形式记录通过 SADP 查询到得在线 IPC 信息的一个 以 字符串 形式: <?xml version='1.0'?> < IPCBYSADPINFO>
<IPCBySadpCount> </IPCBySadpCount> <IPCBYSADPCFG> <IPCIP> </IPCIP> <IPCPort> </IPCPort> <IPCFactoryType> </IPCFactoryType> <IPCVersion> </IPCVersion> <IPCSerialNo> </IPCSerialNo> <IPCChannelNum> </IPCChannelNum> <IPCMACAddr> </IPCMACAddr> <IPCMaskIP> </IPCMaskIP> <IPCGateWayIP> </IPCGateWayIP> <IPCDNSIP1> </IPCDNSIP1> <IPCDNSIP2> </IPCDNSIP2> //搜索到的设备数量 //IP 地址 //端口号 //厂家类型 //版本号 //序列号 //通道个数 //物理地址 //掩码地址 //网关 //DNS1 服务器 IP 地址 //DNS2 服务器 IP 地址

<IsIPCDNSUse> </IsIPCDNSUse> //是否启用 DNS <IsIPCDHCPUse> </IsIPCDHCPUse> //是否启用 DHCP </IPCBYSADPCFG> <IPCBYSADPCFG> <IPCIP> </IPCIP> //IP 地址 <IPCPort> </IPCPort> //端口号 <IPCFactoryType> </IPCFactoryType> //厂家类型 <IPCVersion> </IPCVersion> //版本号 <IPCSerialNo> </IPCSerialNo> //序列号 <IPCChannelNum> </IPCChannelNum> //通道个数 <IPCMACAddr> </IPCMACAddr> //物理地址 <IPCMaskIP> </IPCMaskIP> //掩码地址 <IPCGateWayIP> </IPCGateWayIP> //网关 <IPCDNSIP1> </IPCDNSIP1> //DNS1 服务器 IP 地址 <IPCDNSIP2> </IPCDNSIP2> //DNS2 服务器 IP 地址 <IsIPCDNSUse> </IsIPCDNSUse> //是否启用 DNS <IsIPCDHCPUse> </IsIPCDHCPUse> //是否启用 DHCP </IPCBYSADPCFG> …………… //根据搜索的设备总数返回同样的数量 </ IPCBYSADPINFO>

25. 获取的 25.7 修改 SADP 获取的在线 IPC 信息
BOOL SetIPCameraInfo(LPCTSTR lpIPVerify, LPCTSTR lpPswVerify, long lPort, LPCTSTR lpIPCInfo) 功能:设置 IPCamera 相关参数信息 参数说明: lpIPVerify: IPCamera 旧的 IP 地址 lpPswVerify: IPCamera 超级用户密码 IPCamera 旧的端口号 lPort: lpIPCInfo: IPCamera 相关参数信息组成的 XML 文件 返回值:TRUE 表示成功,FALSE 表示失败 形式: <?xml version='1.0'?> < IPCBYSADPCFG>
<IPCIP> </IPCIP> <IPCPort> </IPCPort> <IPCFactoryType> </IPCFactoryType> <IPCVersion> </IPCVersion> <IPCSerialNo> </IPCSerialNo> <IPCChannelNum> </IPCChannelNum> <IPCMACAddr> </IPCMACAddr> <IPCMaskIP> </IPCMaskIP> <IPCGateWayIP> </IPCGateWayIP> //IP 地址 //端口号 //厂家类型 //版本号 //序列号 //通道个数 //物理地址 //掩码地址 //网关

<IPCDNSIP1> </IPCDNSIP1> <IPCDNSIP2> </IPCDNSIP2> <IsIPCDNSUse> </IsIPCDNSUse> <IsIPCDHCPUse> </IsIPCDHCPUse>

//DNS1 服务器 IP 地址 //DNS2 服务器 IP 地址 //是否启用 DNS //是否启用 DHCP

</ IPCBYSADPCFG>

26.设置播放窗口模式
Void SetPlayWndType(long lPlayWndType) 功能:设置播放窗口模式 参数说明: lPlayWndType:播放窗口比例模式 0 - 充满, 1 - 4:3 模式, 2 - 16:9 模式 返回值:无

27.备份设录像文件 27.备份设录像文件 获取设备的磁盘列表参数信息 27.1 获取设备的磁盘列表参数信息
BSTR GetDiskList () 功能:获取设备的磁盘列表参数信息 返回值:以 XML 形式记录硬盘录像机支持的磁盘列表信息的一个字 符串 形式: <?xml version='1.0'?> < DISKABILITYINFO>
< DiskAbilityCount> </ DiskAbilityCount> //有效磁盘列表个数 < DISKABILITYCFG> < DiskAbilityType> </ DiskAbilityType> //设备磁盘类型值 < DiskAbilityDescribe> </ DiskAbilityDescribe> //设备磁盘的描述 </ DISKABILITYCFG> < DISKABILITYCFG> < DiskAbilityType> </ DiskAbilityType> // 设备磁盘类型值 < DiskAbilityDescribe> </ DiskAbilityDescribe> // 设备磁盘的描述 </ DISKABILITYCFG> …………… //根据磁盘列表总数返回同样的数量 </ DISKABILITYINFO>

开始备份文件 27.2 开始备份文件
BOOL StartBackup(LPCTSTR lpBackupInfo)

功能:开始文件备份 参数说明: lpBackupInfo 以 XML 形式记录的需要备份文件相关信息 返回值:TRUE 表示成功,FALSE 表示失败 形式:
<?xml version='1.0'?> <BACKUPINFO> < DiskAbilityDescribe> </ DiskAbilityDescribe> //设备磁盘的描述 <IsWithPlayer> </IsWithPlayer> //是否备份播放器 <FileNum> </FileNum> //文件个数 <BACKUPFILE> <Index>dwIndex</Index> <FileName> sFileName </FileName> //录像文件名称 <StartTime> struStartTime </StartTime> //录像文件开始时间 <StopTime> struStopTime </StopTime> //录像文件结束时间 <FileSize> dwFileSize </ FileSize > //录像文件的大小 </BACKUPFILE > <BACKUPFILE > <Index>dwIndex</Index> <FileName> sFileName </FileName> //录像文件名称 <StartTime> struStartTime </StartTime> //录像文件开始时间 <StopTime> struStopTime </StopTime> //录像文件结束时间 <FileSize> dwFileSize </ FileSize > //录像文件的大小 </BACKUPFILE > …………………….. //一样的 N 条记录,最多 20 条 </BACKUPINFO>

27.3 停止备份文件
BOOL StopBackup () 功能:停止文件备份 返回值:TRUE 表示成功,FALSE 表示失败

27.4 获取备份文件进度
long GetBackupPos() 功能:获取备份进度 返回值:-1 表示失败,0-100 表示回放进度,100 表示回放结束,400 表示过程异常, 500 表示过程失败

事件: 事件:
SelectWindow()事件, ()事件 1. 点击控件时触发 SelectWindow()事件,获取当前是哪个控件
FireSelectWindow()

出现异常时返回异常类型 FireExceptionType() ()事件 2. 出现异常时返回异常类型 FireExceptionType()事件
FireExceptionType(wParam, lParam)


相关文档

OCX控件接口说明(V2.3)
【精品】海康OCX控件接口说明(V2.3)
OCX控件接口说明(V2.3.1)
海康威视开发ActiveX控件接口说明(V2.3)
OCX控件手动安装说明
IDCard.OCX控件使用说明
《Smsgate控件(OCX)开发说明书》1
客户端OCX控件开发说明
坐席控件开发接口使用说明最新
写卡器OCX控件demo说明
电脑版