海康威视萤石C2HC智能家用无线网络监控高清夜视wifi手机摄像头机 720P 100万像素 标配+64G内存卡【图片 价格 品牌 报价】-京东
海康威视萤石C2HC智能家用无线网络监控高清夜视wifi手机摄像头机 720P 100万像素 标配+64G内存卡
与行业相比
PLUS会员专享价
您购买此商品可享受专属价
选择新地址
价　格： 到
　　　
规格与包装
本店好评商品
商品名称：海康威视萤石C2HC智能家用无线网络监控高清夜视wifi手机摄像头机 720P 100万像素 标配+64G内存卡
商品编号：
商品毛重：1.0kg
货号：C2HC
监控摄像头：智能摄像头
后端设备（采集卡/DVR/NVR）：32路
安防/报警：安全防护
清晰度：100万(720P)
配件：支架
商品介绍加载中...
权利声明：京东上的所有商品信息、客户评价、商品咨询、网友讨论等内容，是京东重要的经营资源，未经许可，禁止非法转载使用。
注：本站商品信息均来自于合作方，其真实性、准确性和合法性由信息拥有者（合作方）负责。本站不提供任何保证，并不承担任何法律责任。
价格说明：
京东价：京东价为商品的销售价，是您最终决定是否购买商品的依据。
划线价：商品展示的划横线价格为参考价，并非原价，该价格可能是品牌专柜标价、商品吊牌价或由品牌供应商提供的正品零售价（如厂商指导价、建议零售价等）或该商品在京东平台上曾经展示过的销售价；由于地区、时间的差异性和市场行情波动，品牌专柜标价、商品吊牌价等可能会与您购物时展示的不一致，该价格仅供您参考。
折扣：如无特殊说明，折扣指销售商在原价、或划线价（如品牌专柜标价、商品吊牌价、厂商指导价、厂商建议零售价）等某一价格基础上计算出的优惠比例或优惠金额；如有疑问，您可在购买前联系销售商进行咨询。
异常问题：商品促销信息以商品详情页“促销”栏中的信息为准；商品的具体售价以订单结算页价格为准；如您发现活动商品售价或促销信息有异常，建议购买前先联系销售商咨询。
心中疑惑就问问买过此商品的同学吧~
iframe(src='//www.googletagmanager.com/ns.html?id=GTM-T947SH', height='0', width='0', style='display: visibility:')当前位置： > 互联网摄像机萤石c2
海康CS-C2HC-1A1WFR
100W像素1/4&CMOS萤石互联网摄像机 小伊娃
萤石 CS-C2W-21WPFR 130万多功能无线互联网摄像机 wifi摄像头
萤石CS-C2HC互联网摄像机
海康威视萤石云C2S/C2W升级版CO2S无线网络高清互联网监控摄像机
海康威视萤石 C2miniS互联网摄像机 1080P高清 WiFi 智能远程
萤石 CS-C2W-31WPFR 130万多功能无线互联网摄像机 wifi摄像头
萤石CS-C2W-31WPFR 多功能互联网摄像机 高清家用店铺监控卡片机
萤石CS-C2W-21WPFR 多功能互联网摄像机 高清家用店铺监控卡片机
萤石C2minis互联网摄像机1080P高清网络监控摄像机头智能wifi远程
萤石CS-C2W-21WPFR 多功能互联网高清摄像机头家用店铺监控卡片机
海康萤石C2W多功能智能互联网摄像机
海康萤石新品C2Hc 720P 1080P多功能互联网摄像机
C2HC海康威视萤石C2C升级版 多功能互联网无线摄像机WIFI语音对讲
海康威视萤石多功能互联网摄像机C2C升级款C2HC 720P/1080P高清
萤石摄像头无线摄像头多功能互联网摄像机CS-C2C-1B2WFR冲钻
海康威视萤石多功能互联网摄像机C2C升级款C2HC 720P/1080P高清
海康威视萤石多功能互联网摄像机C2C升级款C2HC 720P/1080P高清
海康威视萤石C2C多功能互联网摄像机CS-C2C-1A1WFR
海康威视萤石C2C多功能互联网摄像机 CS-C2C-1A1WFR
海康威视萤石C2C多功能互联网摄像机-1080p版 CS-C2C-1B2WFR
最近更新的...
友情链接：
& 看图网，，该页图片不可商用
在线图片处理软件开发，始创于09年，距今7年。DS:1/0/20
互联网摄像机萤石c2素材下载使用海康DS-4004HC板卡网络SDK碰到的难题
[问题点数：100分，结帖人netcoder]
本版专家分：1424
2004年5月 MS-SQL Server大版内专家分月排行榜第三
CSDN今日推荐
本版专家分：1030
本版专家分：11620
本版专家分：22987
2008年7月 .NET技术大版内专家分月排行榜第三
本版专家分：0
本版专家分：1241
本版专家分：0
本版专家分：0
本版专家分：0
本版专家分：0
本版专家分：158
本版专家分：158
本版专家分：0
匿名用户不能发表回复！|
CSDN今日推荐不积跬步无以至千里。
海康威视DS-HC 系列板卡SDK编程指南
本文转自：
板卡介绍篇............................................................................................................................... ........8&
SDK 版本更新篇............................................................................................................................... 9&
错误代码及说明.............................................................................................................................17 &
数据类型及数据结构定义.............................................................................................................18&
API调用顺序............................................................................................................................... ...19&
函数说明篇............................................................................................................................... ......22&
1. 板卡初始化及卸载..............................................................................................................22&
1.1初始化DSP InitDSPs ................................................................................................22&
1.2卸载DSP DeInitDSPs ...............................................................................................22&
2. 板卡信息获取......................................................................................................................22&
2.1获取系统中板卡的张数GetBoardCount..................................................................22&
2.2获取系统中DSP 的个数GetDspCount......................................................................22&
2.3获取系统中编码通道的个数GetEncodeChannelCount..........................................23&
2.4获取系统中解码通道的个数GetDecodeChannelCount..........................................23&
2.5获取系统中解码显示通道的个数GetDisplayChannelCount..................................23&
2.6获取板卡详细信息GetBoardDetail..........................................................................23&
2.7获取DSP 详细信息GetDspDetail..............................................................................24&
2.8获取板卡型号及序列号信息GetBoardInfo.............................................................25&
2.9获取板卡特殊功能信息GetCapability ....................................................................25&
2.10 获取板卡SDK 信息GetSDKVersion.......................................................................26&
3. 编码卡API ...........................................................................................................................26&
3.1通道打开及关闭 .......................................................................................................26&
3.1.1打开通道ChannelOpen..................................................................................26&
3.1.2关闭通道ChannelClose .................................................................................26&
3.2视频预览...................................................................................................................27&
3.2.1Overlay预览模式............................................................................................27&
3.2.1.1 设置视频预览模式SetPreviewOverlayMode.....................................27&
3.2.1.2 设置overlay关键色SetOverlayColorKey ...........................................27&
3.2.1.3 恢复当前丢失的表面RestoreOverlay................................................27&
3.2.2开启及停止视频预览 ....................................................................................28&
3.2.2.1 开启视频预览StartVideoPreview .......................................................28&
3.2.2.2 停止视频预览StopVideoPreview .......................................................28&
3.2.3视频参数的设置及获取 ................................................................................28&
3.2.3.1 设置视频参数SetVideoPara ...............................................................28&
3.2.3.2 获取视频参数GetVideoPara...............................................................29&
3.3视频信号设置（制式、状况、输入位置等） .......................................................29&
3.3.1设置系统默认的视频制式SetDefaultVideoStandard...................................29&
3.3.2设置视频信号灵敏度SetVideoDetectPrecision ............................................29&
3.3.3获取视频信号输入情况GetVideoSignal......................................................30&
3.3.4调整视频信号输入位置SetInputVideoPosition............................................30&
3.3.5设置反隔行变换及强度SetDeInterlace ........................................................30&
3.4视频编码参数设置 ...................................................................................................31&
版权所有（C）杭州海康威视数字技术股份有限公司& 2
海康威视DS-HC 系列板卡SDK编程指南&
3.4.1主、子通道切换SetupSubChannel...............................................................31&
3.4.2获取双编码时数据流类型GetSubChannelStreamType................................31&
3.4.3编码流类型的设置及获取（不支持动态修改） ........................................32&
3.4.3.1 设置主通道编码流类型SetStreamType.............................................32&
3.4.3.2 获取主通道编码流类型GetStreamType ............................................32&
3.4.3.3 设置子通道编码流类型SetSubStreamType .......................................32&
3.4.3.4 获取子通道编码流类型GetSubStreamType ......................................32&
3.4.4（支持动态修改）的编码参数设置 .............................................................33&
3.4.4.1 设置编码图像质量SetDefaultQuant ..................................................33&
3.4.4.2 设置编码帧结构、帧率SetIBPMode................................................33&
3.4.4.3 设置编码分辨率 .................................................................................33&
3.4.4.3.1 设置主通道分辨率SetEncoderPictureFormat.........................33&
3.4.4.3.2 设置子通道编码分辨率SetSubEncoderPictureFormat ...........34&
3.4.4.4 设置码率及码流控制模式 .................................................................34&
3.4.4.4.1 设置码流最大比特率SetupBitrateControl..............................34&
3.4.4.4.2 设置码流控制方式SetBitrateControlMode.............................34&
3.4.5强制设定I帧CaptureIFrame..........................................................................35&
3.4.6获取帧统计信息GetFramesStatistics ............................................................35&
3.5数据捕获...................................................................................................................35&
3.5.1抓图（获取单帧图像数据） ........................................................................35&
3.5.1.1 抓取BMP格式图像............................................................................35&
3.5.1.1.1 获取原始yuv422格式数据GetOriginalImage........................35&
3.5.1.1.2 图像格式转换YUVtoBMP SaveYUVToBmpFile ..................36&
3.5.1.2 抓取JPEG格式图像GetJpegImage .....................................................36&
3.5.2原始图像数据流捕获（获取YUV420 格式数据流） ................................36&
3.5.2.1 注册原始图像数据流回调函数RegisterImageStreamCallback........36&
3.5.2.2 开启及停止原始数据流捕获SetImageStream ...................................37&
3.5.3编码数据流捕获（获取编码后H.264 格式数据流）即录像 .....................37&
3.5.3.1 编码数据流捕获方式设置 .................................................................37&
3.5.3.1.1 方式一、直接读取方式 ..........................................................37&
3.5.3.1.1.1 注册编码图像数据流直接读取回调函数
RegisterStreamDirectReadCallback................................................37&
3.5.3.1.2 方式二、消息读取方式 ..........................................................38&
3.5.3.1.2.1 注册消息读取码流函数RegisterMessageNotifyHandle
.........................................................................................................38&
3.5.3.1.3 方式三、另一种直接读取方式 ..............................................38&
3.5.3.1.3.1 注册直接读取码流回调函数
RegisterStreamReadCallback ..........................................................38&
3.5.3.2 读取码流函数ReadStreamData ..........................................................38&
3.5.3.3 开启及停止录像 .................................................................................39&
3.5.3.3.1 启动主通道编码数据流捕获StartVideoCapture ....................39&
3.5.3.3.2 停止主通道编码数据流捕获StopVideoCapture.....................39&
3.5.3.3.3 启动子通道编码数据流捕获StartSubVideoCapture ..............39&
3.5.3.3.4 停止子通道编码数据流捕获StopSubVideoCapture ...............40&
版权所有（C）杭州海康威视数字技术股份有限公司& 3
海康威视DS-HC 系列板卡SDK编程指南&
3.6移动侦测...................................................................................................................40&
3.6.1设置方式一 ....................................................................................................40&
3.6.1.1 设置移动侦测灵敏度AdjustMotionDetectPrecision .........................40&
3.6.1.2 设置移动侦测区域范围及个数SetupMotionDetection.....................41&
3.6.1.3 移动侦测分析MotionAnalyzer...........................................................41&
3.6.2设置方式二 ....................................................................................................41&
3.6.2.1 设置移动侦测（扩展）SetupMotionDetectionEx............................41&
3.6.3启动及停止移动侦测 ....................................................................................42&
3.6.3.1 启动移动侦测StartMotionDetection ..................................................42&
3.6.3.2 停止移动侦测StopMotionDetection ..................................................42&
3.7视频信息叠加 ...........................................................................................................43&
3.7.1信息叠入视频编码（OSD 、LOGO 、MASK ）.........................................43&
3.7.1.1 OSD.....................................................................................................43&
3.7.1.1.1 设置OSD 显示模式SetOsdDisplayMode.................................43&
3.7.1.1.2 设置OSD 显示模式（扩展）SetOsdDisplayModeEx ............44&
3.7.1.1.3 设置OSD 显示SetOsd ..............................................................45&
3.7.1.2 LOGO ..................................................................................................45&
3.7.1.2.1 数据格式转换（bmp 转yuv422）LoadYUVFromBmpFile ....45&
3.7.1.2.2 设置LOGO 显示模式SetLogoDisplayMode ............................46&
3.7.1.2.3 设置LOGO 显示位置及数据SetLogo .....................................46&
3.7.1.2.4 停止LOGO 显示StopLogo .......................................................46&
3.7.1.3 视频遮挡MASK .................................................................................47&
3.7.1.3.1 设置屏幕遮挡SetupMask ........................................................47&
3.7.1.3.1 停止屏幕遮挡StopMask..........................................................47&
3.7.2仅在预览画面上叠加信息 ............................................................................47&
3.7.2.1 注册画图回调函数RegisterDrawFun.................................................47&
3.7.2.2 停止画图回调StopRegisterDrawFun .................................................48&
3.8音频...........................................................................................................................48&
3.8.1设置音频预览SetAudioPreview....................................................................48&
3.8.2获取音频输入音量幅度GetSoundLevel.......................................................48&
3.9其他...........................................................................................................................48&
3.9.1复位DSP ResetDSP**...................................................................................48&
3.9.2设置看门狗SetWatchDog ..............................................................................49&
3.9.3码流数字水印校验 ........................................................................................49&
3.9.3.1 设置主通道数字水印校验SetChannelStreamCRC ...........................49&
3.9.3.2 设置子通道数字水印校验SetSubChannelStreamCRC .....................49&
4. 解码卡API ...........................................................................................................................50&
4.1解码卡初始化及释放 ...............................................................................................50&
4.1.1初始化及释放解码卡 ....................................................................................50&
4.1.1.1 初始化解码卡HW_InitDecDevice .....................................................50&
4.1.1.2 释放解码卡HW_ReleaseDecDevice ..................................................50&
4.1.2初始化及释放DirectDraw .............................................................................50&
4.1.2.1 初始化DirectDraw HW_InitDirectDraw............................................50&
4.1.2.2 释放DirectDraw HW_ReleaseDirectDraw .........................................51&
版权所有（C）杭州海康威视数字技术股份有限公司& 4
海康威视DS-HC 系列板卡SDK编程指南&
4.1.3打开及关闭解码通道 ....................................................................................51&
4.1.3.1 打开解码通道HW_ChannelOpen ......................................................51&
4.1.3.2.关闭解码通道HW_ChannelClose ......................................................51&
4.2解码卡信息获取 .......................................................................................................51&
4.2.1版本信息获取HW_GetVersion .....................................................................51&
4.3解码卡音视频信号输出设置 ...................................................................................52&
4.3.1音频输出设置 ................................................................................................52&
4.3.1.1 音频预览设置HW_SetAudioPreview................................................52&
4.3.1.2 音频模拟输出设置SetDecoderAudioOutput .....................................52&
4.3.2视频输出设置 ................................................................................................53&
4.3.2.1 视频制式设置 .....................................................................................53&
4.3.2.1.1 设置视频显示通道的视频制式SetDisplayStandard ...............53&
4.3.2.2 视频预览设置 .....................................................................................53&
4.3.2.2.1 设置视频显示参数HW_SetDisplayPara.................................53&
4.3.2.2.2 刷新overlay表面HW_RefreshSurface.....................................53&
4.3.2.2.3 重载overlay表面HW_RestoreSurface.....................................54&
4.3.2.2.4 清除overlay表面中的数据HW_ClearSurface.........................54&
4.3.2.2.5 缩放overlay表面的显示区域HW_ZoomOverlay ...................54&
4.3.2.2.6 预览去闪烁功能HW_SetDecoderPostProcess........................54&
4.3.2.3 视频模拟输出显示区域设置 .............................................................55&
4.3.2.3.1 设置显示区域的形式及参数（视频模拟输出的画面分割情
况）SetDisplayRegion............................................................................55&
4.3.2.3.2 改变某个显示区域的位置SetDisplayRegionPosition ............55&
4.3.2.3.3 用自定义的图像填充显示区域FillDisplayRegion.................56&
4.3.2.3.4 清空显示区域ClearDisplayRegion.........................................56&
4.3.3.4 视频模拟输出设置 .............................................................................56&
4.3.3.4.1 视频解码模拟输出（MD卡内部输出）SetDecoderVideoOutput
.................................................................................................................56&
4.3.3.4.2 视频解码通道模拟输出扩展（MD卡外部输出）
SetDecoderVideoExtOutput....................................................................57&
4.3.3.4.3 视频编码通道模拟输出（MD 卡外部输出）
SetEncoderVideoExtOutput....................................................................57&
4.3.3.4.4 设置视频模拟输出亮度SetDisplayVideoBrightness..............57&
4.4解码卡解码及播放 ...................................................................................................58&
4.4.1解码卡数据解码方式设置（解码数据流、解码录像文件） ....................58&
4.4.1.1 解码卡解码数据流 .............................................................................58&
4.4.1.1.1 打开数据流HW_OpenStream.................................................58&
4.4.1.1.2 关闭数据流HW_CloseStream.................................................58&
4.4.1.1.3 输入数据流HW_InputData.....................................................58&
4.4.1.1.4 流模式下重启解码器HW_ResetStream.................................58&
4.4.1.2 解码卡解码数据流功能扩展（以视、音频分开的形式） .............59&
4.4.1.2.1 打开数据流HW_OpenStreamEx.............................................59&
4.4.1.2.2 关闭数据流HW_CloseStreamEx.............................................59&
4.4.1.2.3 输入视频数据流HW_InputVideoData....................................59&
版权所有（C）杭州海康威视数字技术股份有限公司& 5
海康威视DS-HC 系列板卡SDK编程指南&
4.4.1.2.4 输入音频数据流HW_InputAudioData ...................................59&
4.4.1.3 解码卡解码录像文件 .........................................................................60&
4.4.1.3.1 打开录像文件HW_OpenFile ..................................................60&
4.4.1.3.2 关闭录像文件HW_CloseFile..................................................60&
4.4.1.4 设置及获取流播放参数 .....................................................................60&
4.4.1.4.1 设置流播放模式及参数HW_SetStreamOpenMode ...............60&
4.4.1.4.2 获取流播放模式及参数HW_GetStreamOpenMode ...............60&
4.4.2视音频播放 ....................................................................................................61&
4.4.2.1 视频播放 .............................................................................................61&
4.4.2.1.1 开始视频播放HW_Play ..........................................................61&
4.4.2.1.2 停止视频播放HW_Stop ..........................................................61&
4.4.2.2 音频播放 .............................................................................................61&
4.4.2.2.1 打开声音HW_PlaySound........................................................61&
4.4.2.2.2 关闭声音HW_StopSound........................................................61&
4.4.2.2.3 音量调节HW_SetVolume........................................................61&
4.4.2.3 暂停播放HW_Pause...........................................................................62&
4.4.3解码播放信息设置及获取 ............................................................................62&
4.4.3.1 解码播放速度设置及获取 .................................................................62&
4.4.3.1.1 设置播放速度HW_SetSpeed ..................................................62&
4.4.3.1.2 获取播放速度HW_GetSpeed..................................................62&
4.4.3.2 解码播放位置设置及获取 .................................................................63&
4.4.3.2.1 设置播放位置HW_SetPlayPos ...............................................63&
4.4.3.2.2 获取播放位置HW_GetPlayPos ...............................................63&
4.4.3.3 设置解码播放跳跃 .............................................................................63&
4.4.3.3.1 设置播放跳跃时间间隔HW_SetJumpInterval .......................63&
4.4.3.3.2 设置播放跳跃方向HW_Jump.................................................63&
4.4.4解码时间及帧信息获取 ................................................................................64&
4.4.4.1 时间信息获取 .....................................................................................64&
4.4.4.1.1 获取文件总时间HW_GetFileTime.........................................64&
4.4.4.1.2 获取当前播放帧的时间（相对时间）
HW_GetCurrentFrameTime....................................................................64&
4.4.4.1.3 获取文件的起止的绝对时间HW_GetFileAbsoluteTime .......64&
4.4.4.1.4 获取文件当前播放的绝对时间HW_GetCurrentAbsoluteTime
.................................................................................................................64&
4.4.4.1.5 按照绝对时间定位文件播放位置HW_LocateByAbsoluteTime
.................................................................................................................65&
4.4.4.2 帧信息获取 .........................................................................................65&
4.4.4.2.1 获取文件总帧数HW_GetFileTotalFrames..............................65&
4.4.4.2.2 获取已解码的视频帧数HW_GetPlayedFrames.....................65&
4.4.4.2.3 获取当前播放帧率HW_GetCurrentFrameRate......................65&
4.4.4.2.4 获取当前播放帧序号HW_GetCurrentFrameNum.................66&
4.4.4.2.5 按照帧号定位文件播放位置HW_LocateByFrameNumber ...66&
4.5数据捕获...................................................................................................................66&
4.5.1抓图................................................................................................................66&
版权所有（C）杭州海康威视数字技术股份有限公司& 6
海康威视DS-HC 系列板卡SDK编程指南&
4.5.1.1 抓取MD卡解码后YV12格式图像HW_GetYV12Image..................66&
4.5.1.2 图像格式转换（YV12转为BMP）HW_ConvertToBmpFile ..........66&
4.5.2录像................................................................................................................67&
4.5.2.1 启动码流捕获HW_StartCapFile........................................................67&
4.5.2.2 停止码流捕获HW_StopCapFile........................................................67&
4.5.2.3 获取码流中图像尺寸HW_GetPictureSize........................................67&
4.5.3解码后原始数据流捕获（YUV420 格式）................................................68&
4.5.3.1 MD 卡解码通道原始图像数据回调 ...................................................68&
4.5.3.1.1 注册解码通道数据流捕获回调函数
RegisterDecoderVideoCaptureCallback ..................................................68&
4.5.3.1.2 设置解码通道数据流捕获函数HW_SetDecoderVideoCapture
.................................................................................................................68&
4.5.3.2 MD 卡显示通道原始图像数据回调 ...................................................69&
4.5.3.2.1 注册显示通道数据流捕获回调函数
RegisterDisplayVideoCaptureCallback...................................................69&
4.5.3.2.2 设置显示通道数据流捕获函数SetDisplayVideoCapture .......69&
4.6其他...........................................................................................................................69&
4.6.1文件结束标志HW_SetFileEndMsg..............................................................69&
4.6.2文件索引 ........................................................................................................70&
4.6.2.1 设置文件索引HW_SetFileRef...........................................................70&
4.6.2.2 文件索引导入HW_ImportFileRef .....................................................70&
4.6.2.3 文件索引导出HW_ExportFileRef .....................................................70&
4.6.3解码画图回调（在offscreen 预览模式下有效） .........................................71&
4.6.3.1 注册解码画图回调函数HW_RegisterDrawFun................................71&
4.6.3.2 停止解码画图回调函数HW_StopRegisterDrawFun.........................71&
5.0 版本SDK新增函数..........................................................................................................71&
编码通道音频矩阵输出（内部输出）SetEncoderAudioOutput ..................71&
编码通道音频矩阵输出（外部输出）SetEncoderAudioExtOutput............72&
解码通道音频矩阵输出（外部输出）SetDecoderAudioExtOutput............72&
函数索引（按英文字母排序）.....................................................................................................72&
附录............................................................................................................................... .................74&
板卡介绍篇&
海康威视DS-HC 系列是面向数字监控行业而推出的专用板卡，采用了高性
能的视频压缩技术标准H.264 及OggVorbis(相当于G.722) 的音频编码标准，完全依靠硬件实
现了视频及音频的实时编码（CIF 格式25 帧PA L /& 3 0 帧NTSC）并精确同步，实现了动态
码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警等功能，能独
立调整各通道参数，性能稳定而且可靠。与MPEG-I产品相比，在保持同等图像质量的前提
下，能大大节省存储空间、并非常适合宽带网或窄带网的传输，是新一代数字监控产品的最
海康威视DS-HC 系列板卡SDK 分为三部分，分别为系统 SDK 、网络 SDK 、
播放SDK ，本文档专门描述系统SDK ，其他SDK请参照我公司相关文档。系统SDK 是专
门为该系列板卡设计的本地录像软件接口程序，以动态连接库的形式提供给应用软件开发
者，并同时附有演示程序（HikVision H.264 System Demo）及其源码，能有效地缩短应用
软件的开发周期。&
在使用过程中，特别提醒软件开发人员，DS-HC 系列板卡可以在编码的同
时修改除码流类型(复合流、纯视频流、音频流)外的所有参数，包括分辨率、码流、帧结构。
譬如在压缩过程中可改变帧率（SetIBPMode）、量化系数（SetDefaultQuant ）、分辨率、码流、
帧结构而无须停止、启动压缩。播放器会自动识别帧率、分辨率等参数，按当前压缩帧率、
分辨率播放且声音图像播放保持正常。&
通过动态修改量化系数（I、B 、P）可控制压缩码率，当码率太高时，加大量化系数；
当码率太低时，减少量化系数。当然，在量化系数满足的情况下，不必再降低量化系数。&
DS-HC 系列压缩卡的运动检测独立于压缩，不进行压缩也可以进行运动检
测。可动态改变帧率非常有价值，在无运动时按低帧率录像，运动时按高帧率录像，记录在
同一个文件内，可大大节省硬盘空间。&
DS-4004HC板卡支持4 路的DCIF/2CIF/CIF/QCIF 实时编码压缩，也支持2 路的 4CIF
实时编码压缩。若需要作为4CIF编码录像，应用程序可以从DS-4004HC的4 个编码通道
中任意选取两个通道设置为4CIF分辨率，然后对这两个通道进行录像，此时，此DS-4004HC
卡的另外两个通道的图像可以作为视频预览或者不予以显示.&
DS-4008HC板卡支持8 路的2CIF/CIF/QCIF实时编码压缩，也支持4 路的4CIF实时编码
压缩。若需要作为 4CIF编码录像，应用程序可以从DS-4008HC 的8 个编码通道(编码通道为
0 ，1，2 ，3，4 ，5 ，6，7& )中的前面4 个通道(0,1,2,3) 任意选取两个通道设置为 4CIF分辨率，
再从后面4 个编码通道(4,5,6,7) 中任意选取两个通道设置为 4CIF分辨率，然后对这选中的四
个通道进行录像；对于DS-4004HC和DS-4008HC板卡，通过子通道编码，可以把每一个通道
全部设置为4CIF分辨率（SetSubEncoderPictureFormat ），这样每一个通道就都可以实现 4CIF
编码，然后通过函数StartSubVideoCapture 实现每个通道的 4CIF分辨率录像。在一般场景下，
每路图像都可以达到15 帧以上。&
DS-4016HCS：16路视音频压缩卡。支持 16路CIF 音视频实时压缩，支持CIF/QCIF
分辨率，不支持4CIF、2CIF、DCIF分辨率，不支持双编码。&
DS-4008HS 、DS-4016HS ：1 芯8 路视音频压缩板卡，每个 DSP 支持8 路CIF 音视频实
时压缩，支持CIF/QCIF分辨率，不支持4CIF、2CIF、DCIF分辨率，不支持双编码。&
DS-4108HCV 、DS-4116HCV ：采用DM 648 DSP，DS-4108HCV 包含1 个DSP ，
DS-4116HCV 包含2 个DSP ，& 每个DSP 支持8 路DCIF/2CIF/CIF/QCIF，或者 4 路4CIF分
版权所有（C）杭州海康威视数字技术股份有限公司& 8
海康威视DS-HC 系列板卡SDK编程指南&
辨率音视频压缩，每张板卡支持1 路模拟视频矩阵输出和1 路模拟音频矩阵输出功能，41
系列板卡音频实时监听功能不需用4 针线连接板卡和声卡音频输入口。&
SDK版本更新篇&
5.0版本（）：&
z&& 支持全新推出的DS-4100HCV 卡（DS-4108HCV、DS-4116HCV）。&
z&& 5.0& 版本SDK 兼容DS-4100HCV 、DS-4000HC/HC+/HCS/HF/HS/MD/ 系列板卡，不
再兼容DS-4000H系列板卡。&
z&& 新增音频矩阵输出功能，可将任意编码通道或者解码通道的音频数据输出到任意模
拟音频输出口上，本功能适用于HCV卡和MD卡。&
z&& HCV卡视频矩阵输出功能使用函数SetEncoderVideoExtOutput实现，与MD卡本
地矩阵输出功能相同，音频矩阵输出使用新增函数SetEncoderAudioOutput 或者
SetEncoderAudioOutputExt实现。&
修正bug ：&
z&& 解决了移动侦测区域判断出错的问题&
z&& 解决了HS卡全屏预览反复启停时错位的问题。&
新增API 函数：&
SetEncoderAudioOutput &
SetEncoderAudioExtOutput &
SetDecoderAudioExtOutput &
4.3版本（ ）：&
z&& 支持全新推出一芯八路DS-4000HS 卡（DS-4008HS 、DS-4016HS ），每块DSP 支
持8 路cif/qcif 编码，不支持子码流，支持YUV抓图、JPG 抓图、原始视频捕获、
本地矩阵输出&
z&& 新增4000HC 系列DS-4016HC卡，16 路视音频压缩板卡，功能与原 DS-4004HC、
DS-4008HC板卡相同&
z&& 编解码性能提升&
z&& 完善了对视频信号检测的判断&
z&& 编解码通道上限扩充至256 路&
z&& 支持纯音频流编码&
z&& 在HC、HC+ 、HF卡上增加了色度串扰的处理&
z&& MD卡解码延时降低&
z&& MD卡启动后默认音频输出改为关闭状态, 之前版本为默认输出前两路音频&
z&& 本地矩阵输出功能增加支持帧率控制(SetEncoderVideoExtOutput)&
z&& 增加MD卡解码视频捕获功能，HW_SetDecoderVideoCapture&
z&& 增加MD卡解码图像显示的回调函数，HW_RegisterDrawFun&
修正bug ：&
z&& 解决：退出应用程序时，界面已经关闭，但SDK可能还没有彻底退出，此时如果
版权所有（C）杭州海康威视数字技术股份有限公司& 9
海康威视DS-HC 系列板卡SDK编程指南&
再启动应用程序，可能会导致死机。&
z&& 解决：GetSoundLevel在HCS 卡的前12路上无法正确执行&
z&& 解决抓图问题：抓 BMP时，可能导致图像错位；抓 JPG 时，可能会返回超时，并
且无法恢复。&
z&& 解决：如果用户采用多线程来输入码流，MD卡可能会出现多路图像混叠情况。&
z&& 解决：MD卡回放时文件尾部数据可能无法解码&
z&& 解决：MD卡解码N 制QCIF花屏。&
z&& 解决几个显卡预览相关问题。&
新增API 函数：&
RegisterDecoderVideoCaptureCallback&
HW_SetDecoderVideoCapture&
HW_RegisterDrawFun&
4.2版本() ：&
z&& 支持全新推出的DS-4008HF 卡&
z&& 编解码改善对噪声图像的处理，使蠕动现象不明显&
z&& 增加对码流的CRC校验功能&
z&& DS-4000MD卡增加文件索引导入、导出功能&
z&& DS-4000MD卡增加视频输出亮度调整功能&
z&& 增强DS-4000MD卡在流模式下的功能，设置速度、暂停、定位等功能可以在流模
z&& 增加DS-4000MD卡模拟输出视频捕获功能&
z&& 新增隔行解码功能&
z&& 解码后增加后处理&
z&& 解决DS-4000MD卡无法解码某些小文件问题&
z&& 解决DS-4000MD卡无法解码某些文件尾部一段数据的问题&
z&& 解决部分DS-4004MD卡音频输出顺序混乱问题&
z&& 解决DS-4000MD卡多路解码时，音频输出通道间可能会混乱的问题&
z&& 解决4.1版本解码时音频可能有杂音的问题&
新增API 函数：&
SetChannelStreamCRC&&&&&&&& SetSubChannelStreamCRC&
&HW_ImportFileRef&&& HW_ExportFileRef&
& SetDisplayVideoCapture&&&&&& RegisterDisplayVideoCaptureCallback&
&HW_SetDecoderPostProcess& SetDisplayVideoBrightness&
4.1版本() ：&
z&& 支持全新推出的DS-4000HC+卡&
z&& 编码性能优化，全面提升图像质量，特别是4CIF的图像质量有很大提高&
z&& DS-4000MD卡增加文件索引功能，支持按照时间或帧号定位功能，并可以获取录
像文件的起止时间&
版权所有（C）杭州海康威视数字技术股份有限公司& 10
海康威视DS-HC 系列板卡SDK编程指南&
z&& MD卡支持抓图&
z&& DS-4000MD卡无法解码某些子通道的录像文件&
z&& DS-4000MD矩阵输出时可能会出现图像错误&
z&& DS-4000MD卡回放小文件时，可能会误报文件结束&
z&& DS-4000HC原始图像流的帧率控制无效(Ver:4.0)&
z&& 录像音频的音量偏小(Ver:3.0-4.0)&
4.0版本() ：&
z&& 支持新的板卡：DS4016HCS、DS4004MD &
DS4016HCS：16路视音频压缩卡。支持 16 路CIF 实时压缩，支持CIF/QCIF分辨率，
不支持4CIF、2CIF、DCIF分辨率，不支持双编码。新增加了 WatchDog
和报警输入、输出功能&
DS4004MD ： 8路解码、4 路输出矩阵解码卡。产品功能和 2 块DS4002MD 相同;&
z&& 视频预览帧率可调(PAL:1-25f/s,NTSC:1-30f/s);&
z&& 增加新的移动侦测接口SetupMotionDetectionEx，提供了更灵活的功能，并且简化
了用户的工作量；对于移动侦测的操作应用程序仅需调用3 个接口函数:&
SetupMotionDetectionEx、StartMotionDetection 和StopMotionD&
在应用程序以新的接口函数实现移动侦测功能时，SDK 不再返回移动侦测帧，而
仅仅是通过函&
数SetupMotionDetectionEx所调用的回调函数 MotionDetectionCallback的参数
bMotionDetected&
告知应用程序视频是否处于移动状态；&
z&& 增加新的OSD 接口SetOsdDisplayModeEx，最多支持 8 行OSD 字符。同时，修改
OSD 参数时无需重新启停;&
z&& 对SDK 的发布文件做了简化，实现所有的功能只需ds40xxsdk.dll 一个文件;&
z&& SDK 内部增加了异常检测、恢复机制，增强系统稳定性，无需用户干预;&
z&& 在DS4016HCS上实现了WatchDog功能, 接口函数为SetWatchDog，只要打开任意
一块DS4016HCS的WatchDog功能，就可以实现对上层软件和系统中所有压缩板
卡的运行状态监控;&
z&& 在DS4016HCS上增加了报警输入、输出功能，当配合报警卡使用时，一块
DS4016HCS支持16 路报警输入和 4 路报警输出，同时增加RS485 串口，并提供
了简单、实用的串口操作API;&
z&& MD卡矩阵功能增强;&
z&& MD卡完善了9 画面分割视频输出；&
z&& 增加新的接口函数GetJpegImage ，支持 JPEG 方式抓图，抓取的图像质量动态可调；&
z&& 抓图中存在的图像质量差的问题。(增加了反隔行变换)；&
z&& OSD 时钟不准确。OSD 时钟始终以主机时钟为准，同时SetupDateTime函数不再
有效，用户无须自行校时；&
z&& MD卡在频繁切换画面分割时可能产生执行失败的现象；&
3.3版本() ：&
版权所有（C）杭州海康威视数字技术股份有限公司& 11
海康威视DS-HC 系列板卡SDK编程指南&
z&& 编码效率进一步提高；&
z&& 优化不规则窗口预览丢帧的情况；&
z&& 修正overlay预览的开发在vb、dephi下可能存在的&
HC卡更新:&
z&& 编码质量进一步提高，在相同量化系数下，新版本SDK对大部分场景的压缩比比
旧版本提高10-20%，即在提供同等图象质量情况下，新版本的码流比旧版本降低
z&& 移动侦测采用全新算法，增加自适应选项(只要将AdjustMotionDetectPrecision 函数
的将运动分析灵敏度等级参数iGrade 和0x 做“或”操作, 即采用自适应分
析)，在光线不足的情况下移动检测的准确率大大提高；&
z&& 在部分显卡上实现overlay预览(函数SetPreviewOverlayMode)，提高了预览的画质
和降低系统的CPU 使用率；&
z&& 反隔行算法优化，提高了预览图象质量；&
z&& 取原始数据流的效率提高，运行时CPU 的使用率下降；&
z&& 码流控制算法优化；&
z&& 海外板卡(DS-4000HCI)支持PCI_X 主板；&
z&& 驱动程序进行了更新，跟旧版本SDK 不兼容(3.2 版本中的驱动程序和 SDK 不能与
旧版本中的驱动程序和SDK 交叉使用)；&
z&& 同一路视频编码信号支持2 路矩阵输出；&
MD卡更新：&
z&& 优化网络解码延时；&
z&& 完善PCI 传输；&
z&& 增加水平1/3 缩小，可实现9 画面分割视频输出，宽度需要按照 232 对齐；&
修正bug: &
z&& 修正了HC卡OSD 时间错误的bug；&
新增功能：&
z&& H 卡与HC卡混插时，H 卡也可以在录像时动态更改分辨率；&
z&& 解码器性能优化，与3.0相比提高约50 ％；&
z&& 完善MD卡的解码功能，提高了图像显示和音频输出的质量。&
z&& 在MD卡中完善了对原 4004D 卡中已有功能的支持，绝大部分 API 和原4004D 卡
z&& 完善LOGO 配置，对SetLogoDisplayMode 和SetLogo 的使用，无需再考虑先后顺
z&& 完善图像处理，预览和回放的图像质量有所提高；&
z&& HC卡子通道可以在录像时动态更改分辨率；&
z&& 增加了设置反隔行变换参数的接口SetDeInterlace ，用户可以设置是否执行反隔行
变换，以及反隔行变换的强度，请参考相应的函数说明；&
修正bug ：&
z&& 解决了DS-4008HC卡启动顺序混乱的问题；&
版权所有（C）杭州海康威视数字技术股份有限公司& 12
海康威视DS-HC 系列板卡SDK编程指南&
z&& 同时启动主通道和子通道，如果包含4CIF分辨率，对该路图像的反隔行变换可能
会被忽略；&
z&& 原始图像流功能在长时间运行后会停止。&
3.0& 版本&
新增功能：&
z&& 增加DS-4002MD（矩阵解码卡）支持，基于 DS4002MD 可以实现视频矩阵和硬件
解码功能（请参考《DS4002MD 、数字视频矩阵方案》）。&
z&& 优化系统调度、增强编码功能。子通道录像可以设置为复合流或视频流，录像的分
辨率可以任意设置，不再仅限于QCIF。可以组成更灵活的编码方案，例如：&
4 路4CIF非实时录像；主通道 4CIF＋子通道CIF录像等，请参考“双编码功能说明
z&& 增加OSD 字符大小调节功能，用户可自定义 OSD 字符大小，也可以设置为根据编
码分辨率自动调整SetOsdDisplayMode。&
z&& 增加调节视频输入信号检测灵敏度功能。避免因视频输入信号的偶然变化，使“无
视频信号”提示频繁出现，影响图像SetVideoDetectPrecision 。&
z&& 增加获取系统信息（板卡、DSP 、编码通道、解码通道、矩阵输出通道……）接口，
用户可以获得更全面的板卡配置。&
已解决的问题：&
z&& 完善多任务处理。&
z&& 在录像的同时修改帧结构等参数时会导致录像文件出现短时间花屏。&
z&& 当分辨率设为CIF 或DCIF时，如果 OSD 设置为半透明，在 OSD 字符（特别是中
文字符）的右下部分会特别亮或特别暗（没有执行透明处理）。&
z&& 在进行4 路2CIF或4 路DCIF录像时，如果视频信号频繁发生变化（PA L N T S C 　 ），
可能会导致某一路录像停止。&
DS-4002MD（矩阵解码卡）可以实现视频矩阵和硬件解码功能。&
1 、解码功能&
3/4 & 每块DS-4002MD可做4 路解码。&
3/4 & 支持的码流格式：海康威视 H、HC系列板卡；海康威视 M、ME、AT M、HC、
DVS 系列嵌入式设备。&
3/4 & 音、视频输出：&
z&& 音频输出：2 路，可在4 个解码通道中任选2 路输出。&
z&& 视频输出：2 路，每路视频输出最多可以划分为16 个窗口。&
z&& 音频预览：每块DS-4002MD支持1 路音频预览输出。&
3/4 & 软件：从海康威视3.0版SDK 开始提供对DS-4002MD的支持。&
z&& 支持H 卡、HC卡和MD卡在1 台PC内混插。&
z&& 在一个SDK 内同时支持H 卡、HC卡和MD卡。&
z&& 解码部分的API，绝大部分和原海康威视 DS-4004D解码卡的SDK完全兼容
（功能发生变动的API详见“附录”）。&
3/4 & 目前1 台PC最多支持16 块DS-4002MD卡，即最多支持 64 路解码，32路视
3/4 & 基本解码性能（值为每解码1 路视频大约要占用的 DSP 资源）：&
z&& CIF：12％（512Kb ）；16％（2Mb ）&
版权所有（C）杭州海康威视数字技术股份有限公司& 13
海康威视DS-HC 系列板卡SDK编程指南&
z&& 2CIF：30％（1Mb ）&
z&& DCIF：28％（768Kb ）&
z&& 4CIF：50％（1.5Mb ）；60 ％（3Mb ）&
※上述测试文件为定码率下的稳定图像。&
※目前对解码器的进一步优化正在进行中，其性能在以后的版本中会不断的得到提
2 、矩阵功能&
3/4 & 视频矩阵功能可以概括为：&
z&& 视频输入端：由 HC卡实时采集的视频、MD卡解码后视频（本地文件或
网络实时流）。&
z&& 视频输出端：MD的视频输出通道。视频输出支持画面分割，每路视频输
出最多可划分为16 窗口，视频矩阵以窗口为单位进行图像切换。&
z&& 矩阵控制：对于1 台PC中的所有HC卡和MD卡，HC卡的每个编码通
道和MD 卡的每个解码通道，都可以把本通道的视频输出到任意一块MD 卡的任
意一路显示通道中的任意一个窗口进行显示。&
3/4 & 矩阵的基本参数：&
z&& 每块DS-4002MD支持2 路矩阵输出，每路输出为4CIF分辨率。&
z&& HC卡的每个编码通道可以同时支持1 路显卡预览和 2 路矩阵输出。&
z&& MD卡的每个解码通道可以同时支持1 路显卡输出和 2 路矩阵输出。&
z&& 每路视频输出都支持画中画功能，每个窗口的位置动态可调。&
z&& 每路视频输出总的窗口面积之和不能超过4CIF＋2*QCIF，即最大可以实
现一个4CIF的全屏输出＋2 个QCIF的画中画输出。&
GetBoardCount&
GetDspCount&
　 GetBoardDetail&
GetDspDetail&
　 GetEncodeChannelCount&
GetDecodeChannelCount&
　 SetSubStreamType&
　 GetSubStreamType&
　 SetDefaultVideoStandard&
　 SetVideoDetectPrecision&
　 SetOsdDisplayMode（扩展）&
视频输出、矩阵控制相关API:&
　 GetDisplayChannelCount&
　 SetDisplayStandard&
　 SetDisplayRegion &
　 ClearDisplayRegion&
　 SetDisplayRegionPosition&
　 FillDisplayRegion&
　 SetEncoderVideoExtOutput&
　 SetDecoderAudioOutput&
　 SetDecoderVideoOutput&
版权所有（C）杭州海康威视数字技术股份有限公司& 14
海康威视DS-HC 系列板卡SDK编程指南&
　 SetDecoderVideoExtOutput&
解码API：&
& 详见原解码卡的SDK 。需要注意的事项，请参考“DS4002MD 说明”&
2.1& 版本&
z&& 修正了2.0版本中做 4CIF录像时, 录像文件中存在色块的bug。&
z&& 修正2.0版本中无视频信号检测失败的 bug。&
z&& 视频预览时,Overlay 颜色的底色可以由用户自己自由设置, 调用函数
SetOverlayColorKey 设置的Overlay颜色要与对应的预览窗口设置的颜色一样。&
z&& 改进系统调度和通讯，提高数据传输效率，减少预览丢帧，预览更流畅。&
z&& 优化图像处理算法，编码图像与预览图像质量有所提高。&
z&& 改进编码器，编码效率大幅提高，同时改善录像质量。在现有 4004HC 卡上可以做
到两路4CIF实时编码，或者4 路2CIF(PAL:704*288 NTSC:704*240) 实时编码。&
z&& 增加新的编码分辨率：Double CIF(ENC_DCIF_FORMAT) ，PA L ：528*384 ，NTSC：
528*320。&
DCIF和CIF 相比，在相同的码流下，图像质量和线数会有明显提高。&
z&& 系统配置更加灵活，可以在编码的同时修改除码流类型(复合流、视频流)外的所有
参数，包括分辨率、码流、帧结构等。在编码过程中，也可以检测到视频信号制式
的改动，并自动切换对应的编码、预览图像的大小。&
z&& 升级码流格式，可以支持任意改变录像分辨率而不用切换文件(需要配合新的解码库
z&& 增加捕获原始图象流时可以设置帧率的功能。&
z&& 修正了旧版本的一些BUG。&
注意事项：&
1 、 由于DCIF编码的计算量大，如果 4 路同时做DCIF编码，可能会有丢帧现象。在后
续版本中，会随着软件的不断优化而得到改善。&
2 、 由于新的版本不再限制各个通道的分辨率，因此，用户所设置的功能可能会超过了
板卡所能达到的上限，此时会导致录像文件丢帧或者操作失败。例：&
3/4 & 4 个通道同时做 Double CIF 编码，或者做4 路2CIF编码同时还启动了4 个子通道
的双编码：此时，系统会根据图像的复杂性做出丢帧处理。&
3/4 & 4 个通道同时启动 4CIF编码：由于编码 4 路4CIF图像所需要的资源不够，导致启
动失败，同时返回错误(ERR_NOT_SUPPORT) 。&
3/4 & 4 个通道在做 CIF 编码的同时，动态的把分辨率改为 4CIF：同样由于资源不足，该
通道的编码会自动停止，同时返回错误(ERR_KERNEL)。&
z&& 改进小画面预览算法，小画面预览图像更清晰&
z&& 完善板卡视频信号输入判断，在板卡初始化及长时间运行后，给予视频信号相应的
检测和判断&
z&& 完善初始化功能，减少初始化失败情况&
z&& 改进H 卡OSD 显示，使H 卡OSD 显示位置在(0,0,703,575) 内任意可调, 与HC卡的
设置相统一&
版权所有（C）杭州海康威视数字技术股份有限公司& 15
海康威视DS-HC 系列板卡SDK编程指南&
z&& 新增原始图像流捕获函数RegisterImageStreamCallback和SetImageStream&
z&& 新增视频输入位置设置函数SetInputVideoPosition&
z&& 新增停止画图回调功能函数StopRegisterDrawFun&
z&& 增加H 卡设置屏幕遮挡的功能&
z&& 单画面预览窗口大于或等于704*576 时，此窗口预览自动切换为 Overlay预览模式&
z&& 修正了一些BUG&
z&& 改进了在CIF 格式下设置OSD 和LOGO 位置与H 卡对齐&
z&& 修正了SetOsd 不能校时的 BUG&
z&& 全面兼容即将推出的DS4008HC&
z&& 提高LOGO 位图的清晰度&
z&& 改进视频信号丢失检测机制&
z&& 调整默认视频图像参数&
z&& 多窗口时创建与预览窗口同等大小的offscreen& 缓冲区，可对预览窗口矩形框进行
画线及图片显示等，操作更直接方便（参看DEMO 中DrawFun 函数）。&
z&& 新增一个调节OSD 时间的函数，可用于网络校时&
z&& 修正了一些BUG&
1.0版本：&
z&& 保持同等图像质量前提下，与 DS-400xM 系列板卡相比，压缩码流降低 30% 以上，
在办公室典型环境中&&& 码率仅需 20kbps~120kbps。&
z&& 提供精确码率控制方式，无论何种情况均能输出指定码率，增加CBR（定码率）
控制方式。&
z&& 采用新型视频采集处理芯片，极大地降低了由摄像噪声导致的图像失真、背景游动
等现象，预览清晰度提高，可达450 线。&
z&& 采用OggVorbis(相当于G.722) 的音频压缩算法，声音更流畅。&
z&& 支持PCI 2.2接口，传输率更高，可稳定支持大路数（32路以上，最高可达 64 路）
编码与录像。&
z&& 提供高清分辨率（4CIF（704*576））视频压缩编码功能。&
z&& 新增一种直接取数据流方式，读写数据流的效率提高，推荐客户使用。&
z&& 双码流功能更灵活，两路完全独立，可分别启止录像。&
z&& 新增屏幕遮挡MASK 函数，最多支持32 个区域。&
z&& 统一屏幕相对坐标（OSD、LOG、MASK、移动侦测等功能中参数），无论采用何
种编码分辨率，屏幕显示坐标均为704*576&
z&& 修改视频预览方式：多窗口时在显卡上创建offscreen 表面再 BLT 到主窗口；单窗
口且全屏时自动采用OVERLAY 方式。经测试，Nvidia Tnt/Tnt2、Geforce Mx&
200/400/420/440 Fx 系列，& ATI Radeon 00//9200&
/ 系列，MatroxG450/550 系列,INTEL845G/865G 系列支持新的预览方式。
注意显卡的驱动须支持硬件缩放功能， Nvidia Fx 系列显卡驱动推荐使用新版本显
版权所有（C）杭州海康威视数字技术股份有限公司& 16
海康威视DS-HC 系列板卡SDK编程指南&
卡驱动（53.00版本以上）。&
z&& 建议使用AT I 系列显卡以提高显示效率，屏显分辨率设置为 ，颜色设为
z&& SDK 接口与DS-400xM/DS-400xH系列板卡 SDK 原接口一致，新加其他功能（只
适用于HC系列板卡），成型应用软件可迅速完成移植。&
错误代码及说明&
错误号& 解释&
0xc0000001 ERR_WAIT_TIMEOUT& SDK 操作超时；&
0xc0000002 ERR_INVALID_HANDLE& 非法句柄，在调用SDK函数使用了错
误的句柄；&
0xc0000003 ERR_INVALID_ARGUMENT& 参数错误，输入的参数可能超出有效范
0xc0000004 ERR_DDRAW_CREATE_FAILED& DDRAW 返回的错误，参见MSDN&
0xc0000005 ERR_DDRAW_CAPS_FAULT&&& DDRAW 返回的错误，参见MSDN&
0xc0000006 ERR_SET_COOPER ATIVELEVEL_FAILED& DDRAW 返回的错误，参见MSDN&
0xc0000007 ERR_PRIMARY_SURFACE_CREATE_FAILED&&& DDRAW 返回的错误，参见MSDN&
0xc0000008 ERR_GET_OVERLAY_ADDRESS_FAILED& DDRAW 返回的错误，参见MSDN&
0xc0000009 ERR_OVERLAY_SURFACE_CREATE_FAILED&&& DDRAW 返回的错误，参见MSDN&
0xc000000a ERR_OVERLAY_UPDATE_FAILED& DDRAW 返回的错误，参见MSDN&
0xc000000b ERR_TMMAN_FAILURE& SDK 内部错误&
0xc000000c ERR_CHANNELMAGIC_MISMATCH& 通道数据毁坏&
0xc000000e ERR_QUEUE_OVERFLOW& 数据流缓存溢出&
0xc000000f ERR__STREAM_THREAD_FAILURE& 无法启动流处理线程&
0xc0000010 ERR_THREAD_STOP_ERROR& 流处理线程停止错误&
0xc0000011 ERR_NOT_SUPPORT& 该功能尚不支持&
0xc0000012 ERR_OUTOF_MEMORY&&& 系统内存不足&
0xc0000013 ERR_DSP_BUSY& DSP 正忙&
0xc0000014 ERR_DATA_ERROR(v2.4)& 严重数据错误，必须重新停启压缩！&
0xc0000016 ERR_KERNEL& 系统核心错误&
0xc0000017 ERR_OFFSCREEN_CREATE_FAILED& 创建OFFSCREEN 缓冲区错误&
0xc0000019 ERR_INVALID_DEVICE& 无效设备。&
0xc000001a ERR_INVALID_DRIVER& 无效驱动&
MD卡错误代码&
0xc1000001 HWERR_ALLOCATE_MEMORY& 内存分配错误&
0xc1000002 HWERR_INVALID_HANDLE& 无效句柄&
0xc1000003 HWERR_DDRAW_CREATE_FAILED& 创建DirectDraw 失败&
0xc1000004 HWERR_DDRAW_CAPS_FAULT& DirectDraw 表面性能检测失败&
0xc1000005 HWERR_S ET_COOPERATIVELEVEL_FAILED& DirectDraw 设置协作级别失败&
版权所有（C）杭州海康威视数字技术股份有限公司& 17
海康威视DS-HC 系列板卡SDK编程指南&
0xc1000006HWERR_PRIMARY_SURFACE_CREATE_FAILED&& DirectDraw 创建主表面失败&
0xc1000007HWERR_OVERLAY_CREATE_FAILED& DirectDraw 创建Overlay表面失败&
0xc1000008HWERR_GET_OVERLAY_ADDRESS_FAILED& DirectDraw 获取Overlay表面地址失败
0xc1000009HWERR_OVERLAY_UPDATE_FAILED& DirectDraw 显示Overlay表面失败&
0xc100000a HWERR_SURFACE_NULL&& DirectDraw 表面为空&
0xc100000b HWERR_FILEHEADER_UNKNOWN& 文件头未知&
0xc100000c HWERR_CR EATE_FILE_FAILED& 打开文件失败&
0xc100000d HWERR_FILE_SIZE_ZERO& 文件长度为零&
0xc100000d HWERR_FILE_SIZE_INVALID& 文件大小无效&
0xc100000e HWERR_CREATE_OBJ_FAILED& 创建线程或内核对象失败&
0xc100000f HWERR_CHANNELMAGIC_MISMATCH& 通道数据损坏&
0xc1000010 HWERR_PARA_OVER& 参数错误&
0xc1000011 HWERR_ORDER& 函数调用顺序错误&
0xc1000012 HWERR_COMMAND& 命令传递失败&
0xc1000013 HWERR_UNSUPPORTED& 不支持该操作&
0xc1000014 HWERR_DSPOPEN& DSP 打开失败&
0xc1000015 HWERR_DSPLOAD& DSP 加载错误&
0xc1000016 HWERR_ALLOCATE_DSPMEMORY& DSP 内存分配错误&
0xc1000017 HWERR_DSPCHECHER& DSP 校验错误&
0xc1000018 HWERR_IMGFILE_UNKNOWN& 未知的IMG 文件&
0xc1000019 HWERR_INVALID_FILE& 无效文件&
数据类型及数据结构定义&
z&& 视频预览输出格式：&
& vdfRGB16&&&&&&&&&&&&&&&&&&&&&&&&&&& 16 位RGB视频压缩格式&
& vdfRGB24&&&&&&&&&&&&&&&&&&&&&&&&&&& 24 位RGB视频压缩格式&
& vdfYUV422Planar&&&&&&&&&&&&&&&&&&&&& YUV422视频压缩格式&
z&& 帧类型定义&
PktError&&&&&&&& 非法帧数据&
PktSysHeader&&&&&&&&&&&&&&&&&&&&&&&&& 系统头&
PktIFrames&&&&&&&&&&&&&&&&&&&&&&&&&& I 帧包&
PktPFrames&&&&&&&&&&&&&&&&&&&&&&&&&& P 帧包&
PktBBPFrames&&&&&&&&&&&&&&&&&&&&&&& BBP帧包&
PktAudioFrames&&&&&&&&&&&&&&&&&&&&&& 音频帧包&
PktMotionDetection&&&&&&&&&&&&&&&&&&&& 动态监测包&
PktSFrames&&&&&& 2.0版新增，为 I 帧捕获时传送的帧类型&
PktSubIFrames&&&&&& 双编码时，子通道I 帧&
PktSubPFrames&&&&&& 双编码时，子通道P 帧&
PktSubBBPFrames&&&&&& 双编码时，子通道BBP 帧&
版权所有（C）杭州海康威视数字技术股份有限公司& 18
海康威视DS-HC 系列板卡SDK编程指南&
PktSubSysHeader&&&&&& 双编码时，子通道系统头&
z&& 视频标准定义&
&&&&& StandardNone&&&&&&&&&&&&&&&&&&&&&& 无视频信号&
&&&&& StandardNTSC&&&&&&&&&&&&&&&&&&&&& NTSC 制式&
&&&&& StandardPAL&&&&&&&&&&&&&&&&&&&&&&& PAL 制式&
数据结构定义&
z&& 特殊功能能力定义&
typedef struct tagChannelCapability{&
& UCHAR bAudioP&&&&&&&&&&&& 音频预览&
& UCHAR bAlarmIO;&&&&&&&&&&&&&&&& 报警信号&& &
& UCHAR bWatchD&&&&&&&&&&&&&&& 看家狗&
}CHANNEL_CAPABILITY, *PCHANNEL_CAPABILITY;&
z&& 帧数据统计&
typedef struct tagFramsStatistics{&
& ULONG VideoF&&&&&&&&&&&&&& 视频帧&
& ULONG AudioF&&&&&&&&&&&&&& 音频帧&
& ULONG FramesL&&&&&&&&&&&&&&& 丢失帧&
& ULONG QueueO&&&&&&&&&&&& 缓存溢出&
&ULONG CurBps&&&&& 当前码流（kb/s ）&
}FRAMES_STATISTICS, *PFRAMES_STATISTICS;&
z&& 版本信息&
typedef struct tagVersion{&
&ULONG DspVersion, DspBuildN&& DSP版本及BUILD号&
&ULONG DriverVersion, DriverBuildN& 驱动版本及BUILD号&
&ULONG SDKVersion, SDKBuildN&& SDK版本及BUILD号&
}VERSION_INFO, *PVERSION_INFO;&
API 调用顺序&
设置默认的视频制式&&&&& SetDefaultVideoStandard()&&&&&&& &
初始化板卡&&&&&&&&& InitDSPs() &
&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& &
获取编码通道总个数&&&&&&&&& GetTotalChannels()&
打开通道&&&&&&&&&&&&&&&&&&&&& ChannelOpen()&
版权所有（C）杭州海康威视数字技术股份有限公司& 19
海康威视DS-HC 系列板卡SDK编程指南&
注册画图回调&&&&&&&&&&&&&&&&&&&&&& RegisterDrawFun()&
注册获取压缩编码数据流直接读取回调& RegisterStreamDirectReadCallback() &
注册读取码流消息函数&&&&&&&&&&&&&&&& RegisterMessageNotifyHandle()&
注册获取原始图像数据流的回调函数&&&& RegisterImageStreamCallback() &
设置Overlay关键色&&&&& SetOverlayColorKey() &
设置视频预览模式&&&&&&& SetPreviewOverlayMode()&
启动视频图像预览&&&&&&&&& StartVideoPreview()&
// 设置OSD&
设置OSD 显示模式(此函数支持2 行OSD 显示)&& SetOsdDisplayMode()&
设置OSD 显示模式(此函数最多支持8 行OSD 显示)&& SetOsdDisplayModeEx()&
设置OSD 显示&&&&&&&&&& SetOsd() &
// 设置Logo&
将24 位bmp 文件转成yuv 格式的数据&&&&&&& LoadYUVFromBmpFile()&
设置LOGO 显示模式&&&&&&&& SetLogoDisplayMode() &
设置LOGO 图像位置及数据&&&&&&&&&&&&&&&&&&& SetLogo()&
// 设置遮挡&
设置屏幕遮挡&&&&&&&& SetupMask()&
设置主通道的编码分辨率格式：& SetEncoderPictureFormat() &
设置主通道编码流类型：&&&& SetStreamType()&
设置编码图像质量：&&&& SetDefaultQuant() &
设置编码帧结构、帧率：&&&& SetIBPMode()&
设置码流的最大比特率：&&&& SetupBitrateControl()&
设置码流控制模式：&&&& SetBitrateControlMode() &
设置图像亮度、对比度、饱和度：& SetVideoPara()&
&G．移动侦测方式1&
设置移动侦测灵敏度：&& AdjustMotionDetectPrecision()&
设置移动侦测区域及个数：& SetupMotionDetection()&
启动移动侦测：&&&&& StartMotionDetection() &
移动侦测分析：&&&&& MotionAnalyzer()&
G．移动侦测方式2 &
设置移动侦测：&&&&& SetupMotionDetectionEx()& &
启动移动侦测：&&&&& StartMotionDetection() &
H．抓图及图像保存函数&
获取原始图像：&&&&& GetOriginalImage()&
图像保存为BMP文件：&&&& SaveYUVToBmpFile() &
抓取JPEG 格式图像：&&&& GetJpegImage() &
版权所有（C）杭州海康威视数字技术股份有限公司& 20
海康威视DS-HC 系列板卡SDK编程指南&
I．音频幅度获取及现场声音监听&
获取现场声音音量幅度：&&&& GetSoundLevel()&
设置现场声音监听：&&&& SetAudioPreview()&
J ．获取视频、SDK 及板卡相关信息&
获取视频信号输入情况：&&&& GetVideoSignal()&
获取SDK 版本号：&&&& GetSDKVersion()&
获取视频参数：&&&&& GetVideoPara()&
获取板卡的型号和序列号：& GetBoardInfo()&
获取帧统计信息：&&& GetFramesStatistics()&
获取板卡的详细信息：&& GetBoardDetail()&
获取DSP 的详细信息：&&&& GetDspDetail()&
K．启动录像(编码压缩数据)&
启动主通道数据截取：&& StartVideoCapture() &
L ．启动原始图像数据流的截取&
启动获取原始图像数据流：& SetImageStream() &
M．子通道的参数设置以及录像&
设置子通道编码流类型：&&&& SetSubStreamType()&
设置子通道的编码分辨率格式：& SetSubEncoderPictureFormat()&
切换至子通道:&&&&&&&&&&&& SetupSubChannel(, 1)&
// 其它参数设置方式与主通道相同，可以设置与主通道不同的编码量化系数，帧率
切换回主通道:&&&&&&&&&&&& SetupSubChannel(, 0)&
启动子通道数据截取：&& StartSubVideoCapture()&
停止画图回调函数：&&&& StopRegisterDrawFun()&
停止获取原始图像数据流：& SetImageStream()&
停止移动侦测：&&&&& StopMotionDetection()&
停止主通道数据截取：&& StopVideoCapture() &
停止子通道数据截取：&& StopSubVideoCapture()&
停止视频图像预览：&&&& StopVideoPreview()&
关闭通道：&&&&&& ChannelClose()&
卸载DSP ：&&&&&& DeInitDSPs()&
& 目前，SDK 函数之中除了SetStreamType和SetSubStreamType 不能在板卡编码录像过程
中动态设置以外，其它视频参数，譬如OSD 、Logo、分辨率、帧率、码流、图像量化系数
等参数都可以在编码录像的过程之中动态调整。&
版权所有（C）杭州海康威视数字技术股份有限公司& 21
海康威视DS-HC 系列板卡SDK编程指南&
函数说明篇&
1. 板卡初始化及卸载&
1.1 初始化DSP InitDSPs &
函&& 数： int __stdcall InitDSPs()&
参&& 数：& 无&
返回值：& 系统内可用的编码通道个数。&
说&& 明：& 初始化系统中每一块板卡，应在应用软件程序启动时完成。如果返回值为 0 则表
明初始化失败，可能没有找到相应的DSP 软件模块。&
1.2 卸载DSP DeInitDSPs&
函&& 数：&& int __stdcall DeInitDSPs()&
参&& 数：&& 无&
返回值：&& 0&
说&& 明：&& 关闭每一块板卡上的功能，应在应用软件程序退出时调用。&
2. 板卡信息获取&
2.1 获取系统中板卡的张数GetBoardCount &
函&& 数：&& unsigned int __stdcall GetBoardCount()&
参&& 数：&& 无&
返回值：&& 系统中板卡的总张数。&
说&& 明：&& 获取系统中所有板卡的张数，包含编码卡和解码卡。&
2.2 获取系统中DSP 的个数GetDspCount &
函&& 数：&& unsigned int __stdcall GetDspCount()&
参&& 数：&& 无&
返回值：&& 系统中DSP 的总个数&
说&& 明：&& 获取系统中所有板卡的DSP 的个数。&
版权所有（C）杭州海康威视数字技术股份有限公司& 22
海康威视DS-HC 系列板卡SDK编程指南&
2.3 获取系统中编码通道的个数GetEncodeChannelCount&
函&& 数：&& unsigned int __stdcall GetEncodeChannelCount()&
参&& 数：&& 无&
返回值：&& 系统中编码通道的个数&
说&& 明：&& 获取系统中所有编码卡的编码通道总个数，包含H 系列和HC系列编码卡。&
2.4 获取系统中解码通道的个数GetDecodeChannelCount &
函&& 数：&& unsigned int __stdcall GetDecodeChannelCount()&
参&& 数：&& 无&
返回值：&& 系统中解码通道的个数&
说&& 明：&& 获取系统中MD卡的解码通道个数&
2.5 获取系统中解码显示通道的个数GetDisplayChannelCount&
函&& 数：&& unsigned int __stdcall GetDisplayChannelCount()&
参&& 数：&& 无&
返回值：&& 系统中显示通道的个数&
说&& 明：&& 获取系统中MD卡显示通道的个数，即模拟视频输出通道的个数&
释&& 义：&& 解码通道、显示通道&
MD 卡集成解码、矩阵、画面分割3 项功能。每块 DSP 包含4 个解码通道和 2 个显示
通道（见下图所示），解码通道解码的图像可以输出到任意一个DSP 的任意一个显示通道上，
实现矩阵功能，每个显示通道最多支持16画面分割，即在同一个显示通道上最多可以同时
显示前端16 路视频信号。&
2.6 获取板卡详细信息GetBoardDetail &
函&& 数：&& int __stdcall GetBoardDetail(UINT boardNum,DS_BOARD_DETAIL *pBoardDetail)&
参&& 数：&& UINT boardNum ；板卡索引&
版权所有（C）杭州海康威视数字技术股份有限公司& 23
海康威视DS-HC 系列板卡SDK编程指南&
DS_BOARD_DETAIL *pBoardDetail；板卡信息&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 获取某张板卡的详细信息&
板卡信息结构体&
typedef struct{&
BOARD_TYPE_DS type；板卡型号&
BYTE sn[16]；序列号&
UINT dspCount；此张板卡所包含的 DSP 个数&
UINT firstDspIndex；此张板卡上第一个 DSP 在所有DSP 中的索引&
UINT encodeChannelCount；此张板卡所包含的编码通道个数&
UINT firstEncodeChannelIndex ；此张板卡上第一个编码通道在所有编码通道中的索引&
UINT decodeChannelCount；此张板卡所包含的解码通道个数&
UINT firstDecodeChannelIndex ；此张板卡上第一个解码通道在所有解码通道中的索引&
UINT displayChannelCount；此张板卡所包含的显示通道个数&
UINT firstDisplayChannelIndex ；此张板卡上第一个显示通道在所有显示通道中的索引&
UINT reserved1;&
UINT reserved2;&
UINT reserved3;&
UINT reserved4;&
}DS_BOARD_DETAIL&
2.7 获取DSP 详细信息GetDspDetail &
函&& 数：&& int __stdcall GetDspDetail(UINT dspNum,DSP_DETAIL *pDspDetail)&
参&& 数：&& UINT dspNum；DSP 索引&
DSP_DETAIL *pDspDetail；DSP 信息&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 获取某个DSP 的详细信息&
DSP 信息结构体&
typedef struct{&
UINT encodeChannelCount；此DSP 所包含的编码通道个数&
UINT firstEncodeChannelIndex ；此 DSP 上第一个编码通道在所有编码通道中的索引&
UINT decodeChannelCount；此DSP 所包含的解码通道个数&
UINT firstDecodeChannelIndex ；此 DSP 上第一个解码通道在所有解码通道中的索引&
UINT displayChannelCount；此DSP 包含的显示通道个数&
UINT firstDisplayChannelIndex ；此DSP 上第一个显示通道在所有显示通道中的索引&
UINT reserved1;&
UINT reserved2;&
UINT reserved3;&
UINT reserved4;&
}DSP_DETAIL&
版权所有（C）杭州海康威视数字技术股份有限公司& 24
海康威视DS-HC 系列板卡SDK编程指南&
2.8 获取板卡型号及序列号信息GetBoardInfo&
函&& 数：&& int __stdcall GetBoardInfo(HANDLE hChannelHandle, ULONG *BoardType,& &
UCHAR *SerialNo)&
参&& 数：&& HANDLE hChannelHandle；通道句柄&
ULONG *BoardType；板卡型号&
UCHAR *SerialNo ；板卡ID号,& 内容为板卡序列号的 ASCII 的数值，次序为&
SerialNo[0]& 对应最高位，SerialNo[11]对应最低位。比如卡号为“４００００&
００２３４５”的值对应为 4,0,0,0,0,1,0,0,2,3,4,5& 的整形数组。&
返回值：&& 成功为0 ；失败返回错误号&
说&& 明：&& 获取板卡的型号及序列号信息，只支持编码通道的参数获取。&
板卡型号结构体&
typedef enum {&
DS400XM=0；M 卡（注意：M 系列板卡的 SDK 有所不同）&
DS400XH=1；H 卡&
DS4004HC=2 ；4004HC&
DS4008HC=3 ；4008HC&
DS4016HC=4 ；4016HC&
DS4001HF=5；4001HF&
DS4004HF=6；4004HF&
DS4002MD=7 ；4002MD&
DS4004MD=8 ；4004MD&
DS4016HCS=9；4016HCS&
DS4002HT=10；4002HT&
DS4004HT=11；4004HT&
DS4008HT=12；4008HT&
DS4004HC_PLUS=13；4004HC+&
DS4008HC_PLUS=14；4008HC+&
DS4016HC_PLUS=15；4016HC+&
DS4008HF=16；4008HF&
DS4008MD=17；4008MD&
DS4008HS=18；4008HS&
DS4016HS=19；4016HS&
DS4108HCV=20 ；4108HCV&
DS4116HCV=21 ；4116HCV&
DS5016HC=22,&
INVALID_BOARD_TYPE=0xffffffff,&
}BOARD_TYPE_DS&
2.9 获取板卡特殊功能信息GetCapability&
函&& 数：&& int __stdcall GetCapability (HANDLE hChannelHandle,& &
CHANNEL_CAPABILITY *Capability)&
参&& 数：&& HANDLE& hChannelHandle ；通道句柄&
版权所有（C）杭州海康威视数字技术股份有限公司& 25
海康威视DS-HC 系列板卡SDK编程指南&
CHANNEL_CAPABILITY *Capability；特殊功能&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 获取板卡特殊功能信息&
特殊功能结构体&
typedef struct tagChannelCapability{&
UCHAR bAudioPreview；音频预览&
UCHAR bAlarmIO ；报警信号&
UCHAR bWatchDog；看家狗&
}CHANNEL_CAPABILITY, *PCHANNEL_CAPABILITY&
2.10 获取板卡SDK信息GetSDKVersion &
函&& 数：&& int __stdcall GetSDKVersion(PVERSION_INFO VersionInfo)&
参&& 数：&& PVERSION_INFO VersionInfo ；版本信息&
返回值：&& 成功返回0 ；失败返回错误号。&
说&& 明：&& 获取当前所使用的DSP 、Driver、SDK 版本号&
版本信息结构体&
typedef struct tagVersion{&
ULONG DspVersion, DspBuildNum ；&
DSP 版本号，DSP 的BUILD号，用于软件升级时标明该版本的最后修改时间&
ULONG DriverVersion, DriverBuildNum ；&
Driver 版本号，Driver 的BUILD号，用于软件升级时标明该版本的最后修改时间&
ULONG SDKVersion, SDKBuildNum；&
SDK 版本号，SDK 的BUILD号，用于软件升级时标明该版本的最后修改时间&
}VERSION_INFO, *PVERSION_INFO&
3. 编码卡API&
3.1 通道打开及关闭&
3.1.1打开通道ChannelOpen &
函&& 数：&& HANDLE __stdcall ChannelOpen(int ChannelNum)&
参&& 数：&& int ChannelNum ；通道号（从0 开始）&
返回值：&& 成功返回有效句柄（值可能为0 ）；失败返回 0xFFFFFFFF。&
说&& 明：&& 打开通道，获取编码通道的操作句柄，与通道相关的操作需使用相对应的句柄。&
3.1.2关闭通道ChannelClose &
函&& 数：&& int __stdcall ChannelClose(HANDLE hChannelHandle)& &
版权所有（C）杭州海康威视数字技术股份有限公司& 26
海康威视DS-HC 系列板卡SDK编程指南&
参&& 数：&& HANDLE& hChannelHandle ；通道句柄&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 关闭通道，释放相关资源&
3.2 视频预览&
3.2.1Overlay 预览模式&
释&& 义：& overlay预览模式&
Overlay通常被称为重叠页面或者是覆盖层，是一种需要特定的硬件支持的页面，通常
被用于显示实时视频于主页面之上，而不需要Blit 操作到主页面或用任何方法改变主页面的
内容。使用该方式进行预览可以提高预览的画质和降低CPU 利用率。&
3.2.1.1 设置视频预览模式SetPreviewOverlayMode &
函&& 数：&& int __stdcall SetPreviewOverlayMode(BOOL bTrue)&
参&& 数：&& BOOL bTrue；是否设置 overlay 预览方式，也适用于MD卡&
返回值：&& 0 表示显卡支持板卡的overlay 预览方式；其他值表示显卡不支持&
说&& 明：&& SDK 自3.2 版本起在部分显卡中实现了 HC卡以overlay方式预览的功能（此功&
能不支持与H 卡混插的状态下），可以提高预览的画质和降低CPU 利用率。当预览画面小&
于704*576 时，需要调用该函数来启动 overlay模式，如不设置则自动切换到 offscreen 模式&
进行预览显示，当预览画面大于704*576 时，SDK 自动切换到overlay模式&
3.2.1.2 设置overlay关键色SetOverlayColorKey &
函&& 数：&& int __stdcall SetOverlayColo rKey(COLORREF DestColorKey)&
参&& 数：&& COLORREF DestColorKey；overlay关键色参数（RGB（* ，* ，* ））&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 板卡在显示范围小于704*576 时，调用 SetPreviewOverlayMode可以开启overlay&
预览模式，需调用SetOverlayColorKey设置overlay关键色；当显示范围大于704*576 时，&
板卡自动切换到overlay预览模式，关键色默认设置为RGB（10，10，10 ），也可调用&
SetOverlayColorKey 修改关键色。在这两种情况下，都需要将显示窗口的底色设置为和关键&
色相一致。否则图像将难以显示。&
注意：需要在StartVideoPreview 前调用该函数。&
3.2.1.3 恢复当前丢失的表面RestoreOverlay&
函&& 数：&& int __stdcall RestoreOverlay()&
参&& 数：&& 无&
返回值：&& 成功返回0 ；失败返回错误号&
版权所有（C）杭州海康威视数字技术股份有限公司& 27
海康威视DS-HC 系列板卡SDK编程指南&
说&& 明：&& 恢复当前丢失的表面，例如：当系统按下CTRL+ALT+DEL 时系统的OVERLAY&
表面会被强制关闭，调用该函数可以恢复OVERLAY 表面&
3.2.2开启及停止视频预览&
3.2.2.1 开启视频预览StartVideoPreview
函&& 数：& int __stdcall StartVideoPreview(HAND LE hChannelHandle,HWND WndHandle,& &
RECT *rect,BOOLEAN bOverlay, int VideoFormat, int FrameRate)&
参&& 数：& HANDLE hChannelHandle；通道句柄&
HWND WndHandle；显示窗口句柄&
RECT *rect ；显示窗口内的矩形区域&
BOOLEAN bOverlay ；是否启用Overlay预览模式*&
int VideoFormat ；视频预览格式（目前无效）&
int FrameRate ；视频预览帧率（PA L ：1-25 ，NTSC：1-30 ）&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 启动视频预览，调用SetPreviewOverlayMode后，可进行 overlay模式预览，否
则，将默认采用 offscreen 模式预览。当画面大于 704*576 时，SDK 自动切换到overlay预览
视频预览格式&
vdfRGB16；16位RGB视频压缩格式&
vdfRGB24；24位RGB视频压缩格式&
vdfYUV422Planar ；YUV422 视频压缩格式&
3.2.2.2 停止视频预览StopVideoPreview
函&& 数：&& int __stdcall StopVideoPreview(HANDLE hChannelHandle)& &
参&& 数：&& HANDLE hChannelHandle；通道句柄&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 停止视频预览&
3.2.3视频参数的设置及获取&
3.2.3.1 设置视频参数SetVideoPara
函&& 数：&& int __stdcall SetVideoPara(HANDLE hChannelH andle, int Brightness, int Contrast,&
int Saturation, int Hue)& &
参&& 数：&& HANDLE hChannelHandle；通道句柄&
int Brightness ；亮度值（0-255）&
int Contrast ；对比度（0-127）&
版权所有（C）杭州海康威视数字技术股份有限公司& 28
海康威视DS-HC 系列板卡SDK编程指南&
int Saturation ；饱和度（0-127）&
int Hue ；色调（0-255）&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 设置视频参数&
3.2.3.2 获取视频参数GetVideoPara
函&& 数：&& int __stdcall GetVideoPara(HANDLE hChannelHandle,& &
VideoStandard_t *VideoStandard, int*Brightness, int *Contrast, int *Saturation, int *Hue)&
参&& 数：&& HANDLE hChannelHandle；通道句柄&
VideoStandard_t *VideoStandard；视频制式
int *Brightness；亮度指针值（0-255）&
int *Contrast；对比度指针值（0-127）&
int *Saturation ；饱和度指针值（0-127）&
int *Hue ；色调指针值（0-255）&
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 获取视频参数&
StandardNone ；无视频信号&
StandardNTSC；NTSC 制式&
StandardPAL；PA L 制式&
3.3 视频信号设置（制式、状况、输入位置等）&
3.3.1设置系统默认的视频制式SetDefaultVideoStandard
函&& 数：&& int __stdcall SetDefaultVideoStandard(VideoStandard_t VideoStandard)&
参&& 数：&& VideoStandard_t VideoStandard ；视频制式，默认为PA L &
返回值：&& 成功返回0 ；失败返回错误号&
说&& 明：&& 设置系统默认的视频制式，系统中所有的视频输入通道如果无视频输入或者在系&
统启动的时候，通道会按照所设置的系统默认视频制式进行处理。&
注意：该函数只能在系统初始化（InitDSPs ）之前运行，否则无效&
3.3.2设置视频信号灵敏度SetVideoDetectPrecision
函&& 数：&& int __stdcall SetVideoDetectPrecision( HANDLE hChannel,unsigned int value)&
参&& 数：&& HANDLE hChannel；通道句柄&
unsigned