DS_8000HC系列网络硬盘录像机客户端软件开发包编程手册
版本1.4(Build 050708)
2005-07-08
前言
非常感谢您使用我们公司的设备，我们将为您提供最好的服务。
本手册可能包含技术上不准确的地方或印刷错误。本手册的内容将做定期的更新，恕不另行通知；更新的内容将会在本手册的新版本中加入。我们随时会改进或更新本手册中描述的产品或程序。
目录
第一章简介 (5)
1.1 组成 (5)
1.2 注意事项 (5)
第二章编程指南 (7)
2.1 编程说明 (7)
2.2 函数调用顺序 (8)
第三章数据结构 (11)
3.1 客户端数据结构 (11)
3.1.1 显示模式 (11)
3.1.2 发送模式 (11)
3.1.3设备信息结构 (11)
3.1.4 图像预览参数 (11)
3.1.5 文件信息结构 (12)
3.1.6 上传的报警信息 (12)
3.1.7 报警输出状态 (13)
3.1.8 硬件解码预览图像参数 (13)
3.1.9 日志信息 (13)
3.1.10 设备的状态信息 (15)
3.1.11 ATM DVR上传交易信息 (16)
3.2 设备端参数数据结构 (16)
3.2.1 设备系统配置结构 (17)
3.2.2 网络配置结构 (17)
3.2.3 通道图像配置结构 (18)
3.2.4 压缩参数配置结构 (21)
3.2.5 录像配置参数结构 (21)
3.2.6 解码器参数配置结构 (22)
3.2.7 串口配置结构 (24)
3.2.8 报警输入配置结构 (24)
3.2.9 报警输出配置结构 (25)
3.2.10 本地预览参数配置结构 (25)
3.2.11 视频输出配置结构 (25)
3.2.12 用户参数配置结构 (26)
3.2.13 异常参数配置结构 (27)
3.2.14 帧信息配置结构 (27)
第四章函数说明 (28)
4.1 客户端函数 (28)
4.1.1 初始化 (28)
4.1.2 设置显示模式 (31)
4.1.3 启动/停止监听程序 (31)
4.1.4 获取错误代码 (31)
4.1.5 用户注册 (33)
4.1.6 图像预览 (33)
4.1.6.1 视频参数 (34)
4.1.6.2 叠加字符和图像 (34)
4.1.6.3 播放控制 (35)
4.1.6.4 声音控制 (35)
4.1.6.5 捕获 (36)
4.1.6.6 抓图 (37)
4.1.7 云台控制 (37)
4.1.8 回放与下载 (40)
4.1.8.1 查文件 (40)
4.1.8.2 回放 (41)
4.1.8.3 播放控制 (42)
4.1.8.4 捕获 (42)
4.1.8.5 获取OSD时间 (43)
4.1.8.6 抓图 (44)
4.1.8.7 下载 (44)
4.1.9 报警 (45)
4.1.10 语音对讲 (45)
4.1.11 语音广播 (46)
4.1.12 透明通道 (46)
4.1.13 远程控制本地显示 (47)
4.1.14 远程手动录像 (48)
4.1.15 解码卡 (48)
4.1.16 日志 (50)
4.1.17 获取设备状态 (50)
4.2 设备端配置函数 (51)sdk
4.2.1 参数配置 (51)
4.2.2 恢复默认值 (53)
4.2.3 保存参数 (53)
4.2.4 重启/关闭设备 (53)
4.2.5 远程升级 (53)
4.2.6 远程格式化硬盘 (54)
4.2.7 配置交易信息 (55)
第一章简介
1.1 组成
客户端软件开发包是DS_8000HC系列网络硬盘录像机、DS_6000HC系列网络视频服务器
的配套产品，本手册详细介绍了此软件开发包中各个函数所实现的功能以及使用方法、各个函
数之间的调用关系。
客户端软件开发包主要由客户端操作和设备端操作两大部分组成：
客户端操作：图像预览、文件回放和下载、云台控制、布防/撤防、语音对讲、日志管理、
解码卡等功能。
设备端操作：远程升级、远程重启/关闭、格式化硬盘、参数配置（系统配置、通道配置、
串口配置、报警配置、用户配置）等功能。
本开发包包括以下文件： HCNetSDK.lib, HCNetSDK.dll, HCNetSDK.h, PlayM4.lib,      PlayM4.dll, DsSdk.lib, DsSdk.dll, DataType.h, DecodeCardSdk.h。其中PlayM4.lib,      PlayM4.dll是解码库, DsSdk.lib, DsSdk.dll, DataType.h, DecodeCardSdk.h是硬解码的库函数。
1.2 注意事项
1.2.1 基本注意事项
本软件开发包同时兼容ATM专用设备（DS8002AH和DS8002AHL）和DS8000HC, DS6000系列的网络硬盘录像机。
同时支持TCP、UDP、RTP、MULTICAST网络传输模式。
本客户端可以采用软解码和硬解码（采用MD系列的解码卡）进行网络预览图像，2种模式都支持以下码流格式：QCIF、CIF、2CIF、4CIF、DCIF。
ATM专用设备（DS8002AH和DS8002AHL）只支持CIF的分辨率。
网络预览时，设备的每个通道最多支持6路同时连接，每台设备最多支持24路同时连接。
本开发包同时支持512个用户注册，同时支持100路网络预览和网络回放(回放和下载的总数)，同时支持512路报警上传，解码卡最多支持64路输出。以上均为理论数值，实际情
况还得看设备的运行情况和运行客户端的计算机CPU能力。
1.2.2 显卡注意事项
此软件开发包的图像显示部分采用的是我们公司自己的播放器，播放器的显示部分，主要
采用了DirectDraw 技术。目前使用了off_screen 画面和Blt操作。我们在画面的放大缩小方面
主要依靠显卡的支持，因为通过软件来缩放，会占用大量CPU资源。为此，我们提供了测试系统是否支持的一个接口NET_DVR_IsSupport（），用户可以用它测试在你的系统中播放器是否能正常工作，另外，显示属性里的颜设置应该设置为16位或32位的，对于24位的，我们是不支持的。
我们测试过的几款显卡有以下几种（Win2000下）
显卡型号 显存(M) 是否支持颜转换是否支持缩小是否支持放大
ATI Rage128 32 是 是 是
ATI Radeon LE 32 是 是 是
ATI Radeon 7200 64 是 是 是
nVidia TNT2 Model64 16和32是 是 是
nVidia TNT2 Pro 32 是 是 是
Geforce2 Mx,Mx200,Mx400 32 是 是 是
Geforce4 Mx420,Mx440 32 是 是 是
*****************************************************************************
Sis630 16 否 否 否
Sis305 32 是 否 否
注意：nVidia公司的显卡需要更新最新的驱动，老的驱动可能不支持缩小功能；其他没有测试过的显卡，如果在使用过程中发现不支持某些播放需要的功能，不妨安装该显卡的最新的驱动程序试试。
1.2.3 硬解码注意事项
在此开发包中，网络预览图像时支持软件解码和硬件解码，硬件解码采用的是DS400XMD 系列的解码卡，此解码卡的具体功能请参见相关解码卡的功能书，此解码卡具有视频矩阵功能，并且可以解4CIF的图像。由于功能的增加此解码卡较原来的D卡增加了一些API函数，增加的函数不通过客户端用户可以直接调用，这样以后修改解码卡的库函数时可以不用修改客户端的SDK。客户端和用户应用程序同时对这个解码卡的库函数操作，要注意对解码卡的初始化和释放函数只能做一次，一般都是由客户端来初始化解码卡，解码通道可以重复打开，现在返回的解码句柄其实就是解码通道号。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。