本文档是海康威视DS-4100、4000HC系列板卡SDK的编程指南，详细介绍了如何进行板卡初始化、信息获取、编码卡API的使用，包括通道打开关闭、视频预览、参数设置、数据捕获等功能。还包含了错误代码、数据类型和结构定义，为开发者提供全面的参考。
目 录
板卡介绍篇............................................................................................................................... ........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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列是面向数字监控行业而推出的专用板卡，采用了高性
能的视频压缩技术标准H.264 及OggVorbis(相当于G.722) 的音频编码标准，完全依靠硬件实
现了视频及音频的实时编码（CIF 格式25 帧PA L / 3 0 帧NTSC）并精确同步，实现了动态
码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警等功能，能独
立调整各通道参数，性能稳定而且可靠。与MPEG-I产品相比，在保持同等图像质量的前提
下，能大大节省存储空间、并非常适合宽带网或窄带网的传输，是新一代数字监控产品的最
佳选择。
海康威视DS-4100、4000HC 系列板卡SDK 分为三部分，分别为系统 SDK 、网络 SDK 、
播放SDK ，本文档专门描述系统SDK ，其他SDK请参照我公司相关文档。系统SDK 是专
门为该系列板卡设计的本地录像软件接口程序，以动态连接库的形式提供给应用软件开发
者，并同时附有演示程序（HikVision H.264 System Demo）及其源码，能有效地缩短应用
软件的开发周期。
在使用过程中，特别提醒软件开发人员，DS-4100、4000HC 系列板卡可以在编码的同
时修改除码流类型(复合流、纯视频流、音频流)外的所有参数，包括分辨率、码流、帧结构。
譬如在压缩过程中可改变帧率（SetIBPMode）、量化系数（SetDefaultQuant ）、分辨率、码流、
帧结构而无须停止、启动压缩。播放器会自动识别帧率、分辨率等参数，按当前压缩帧率、
分辨率播放且声音图像播放保持正常。
通过动态修改量化系数（I、B 、P）可控制压缩码率，当码率太高时，加大量化系数；
当码率太低时，减少量化系数。当然，在量化系数满足的情况下，不必再降低量化系数。
DS-4100、4000HC 系列压缩卡的运动检测独立于压缩，不进行压缩也可以进行运动检
测。可动态改变帧率非常有价值，在无运动时按低帧率录像，运动时按高帧率录像，记录在
同一个文件内，可大大节省硬盘空间。
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-4100、4000HC 系列板卡SDK编程指南
辨率音视频压缩，每张板卡支持1 路模拟视频矩阵输出和1 路模拟音频矩阵输出功能，41
系列板卡音频实时监听功能不需用4 针线连接板卡和声卡音频输入口。
SDK版本更新篇
5.0版本（2008-10-6）：
更新：
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版本（2008-06-01 ）：
更新：
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-4100、4000HC 系列板卡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版本(2006-07-26) ：
更新：
z 支持全新推出的DS-4008HF 卡
z 编解码改善对噪声图像的处理，使蠕动现象不明显
z 增加对码流的CRC校验功能
z DS-4000MD卡增加文件索引导入、导出功能
z DS-4000MD卡增加视频输出亮度调整功能
z 增强DS-4000MD卡在流模式下的功能，设置速度、暂停、定位等功能可以在流模
式下使用
z 增加DS-4000MD卡模拟输出视频捕获功能
z 新增隔行解码功能
z 解码后增加后处理
修正bug:
z 解决DS-4000MD卡无法解码某些小文件问题
z 解决DS-4000MD卡无法解码某些文件尾部一段数据的问题
z 解决部分DS-4004MD卡音频输出顺序混乱问题
z 解决DS-4000MD卡多路解码时，音频输出通道间可能会混乱的问题
z 解决4.1版本解码时音频可能有杂音的问题
新增API 函数：
SetChannelStreamCRC SetSubChannelStreamCRC
解码API
HW_ImportFileRef HW_ExportFileRef
SetDisplayVideoCapture RegisterDisplayVideoCaptureCallback
HW_SetDecoderPostProcess SetDisplayVideoBrightness
4.1版本(2005-10-15) ：
更新：
z 支持全新推出的DS-4000HC+卡
z 编码性能优化，全面提升图像质量，特别是4CIF的图像质量有很大提高
z DS-4000MD卡增加文
板卡介绍篇............................................................................................................................... ........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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列板卡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-4100、4000HC 系列是面向数字监控行业而推出的专用板卡，采用了高性
能的视频压缩技术标准H.264 及OggVorbis(相当于G.722) 的音频编码标准，完全依靠硬件实
现了视频及音频的实时编码（CIF 格式25 帧PA L / 3 0 帧NTSC）并精确同步，实现了动态
码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警等功能，能独
立调整各通道参数，性能稳定而且可靠。与MPEG-I产品相比，在保持同等图像质量的前提
下，能大大节省存储空间、并非常适合宽带网或窄带网的传输，是新一代数字监控产品的最
佳选择。
海康威视DS-4100、4000HC 系列板卡SDK 分为三部分，分别为系统 SDK 、网络 SDK 、
播放SDK ，本文档专门描述系统SDK ，其他SDK请参照我公司相关文档。系统SDK 是专
门为该系列板卡设计的本地录像软件接口程序，以动态连接库的形式提供给应用软件开发
者，并同时附有演示程序（HikVision H.264 System Demo）及其源码，能有效地缩短应用
软件的开发周期。
在使用过程中，特别提醒软件开发人员，DS-4100、4000HC 系列板卡可以在编码的同
时修改除码流类型(复合流、纯视频流、音频流)外的所有参数，包括分辨率、码流、帧结构。
譬如在压缩过程中可改变帧率（SetIBPMode）、量化系数（SetDefaultQuant ）、分辨率、码流、
帧结构而无须停止、启动压缩。播放器会自动识别帧率、分辨率等参数，按当前压缩帧率、
分辨率播放且声音图像播放保持正常。
通过动态修改量化系数（I、B 、P）可控制压缩码率，当码率太高时，加大量化系数；
当码率太低时，减少量化系数。当然，在量化系数满足的情况下，不必再降低量化系数。
DS-4100、4000HC 系列压缩卡的运动检测独立于压缩，不进行压缩也可以进行运动检
测。可动态改变帧率非常有价值，在无运动时按低帧率录像，运动时按高帧率录像，记录在
同一个文件内，可大大节省硬盘空间。
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-4100、4000HC 系列板卡SDK编程指南
辨率音视频压缩，每张板卡支持1 路模拟视频矩阵输出和1 路模拟音频矩阵输出功能，41
系列板卡音频实时监听功能不需用4 针线连接板卡和声卡音频输入口。
SDK版本更新篇
5.0版本（2008-10-6）：
更新：
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版本（2008-06-01 ）：
更新：
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-4100、4000HC 系列板卡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版本(2006-07-26) ：
更新：
z 支持全新推出的DS-4008HF 卡
z 编解码改善对噪声图像的处理，使蠕动现象不明显
z 增加对码流的CRC校验功能
z DS-4000MD卡增加文件索引导入、导出功能
z DS-4000MD卡增加视频输出亮度调整功能
z 增强DS-4000MD卡在流模式下的功能，设置速度、暂停、定位等功能可以在流模
式下使用
z 增加DS-4000MD卡模拟输出视频捕获功能
z 新增隔行解码功能
z 解码后增加后处理
修正bug:
z 解决DS-4000MD卡无法解码某些小文件问题
z 解决DS-4000MD卡无法解码某些文件尾部一段数据的问题
z 解决部分DS-4004MD卡音频输出顺序混乱问题
z 解决DS-4000MD卡多路解码时，音频输出通道间可能会混乱的问题
z 解决4.1版本解码时音频可能有杂音的问题
新增API 函数：
SetChannelStreamCRC SetSubChannelStreamCRC
解码API
HW_ImportFileRef HW_ExportFileRef
SetDisplayVideoCapture RegisterDisplayVideoCaptureCallback
HW_SetDecoderPostProcess SetDisplayVideoBrightness
4.1版本(2005-10-15) ：
更新：
z 支持全新推出的DS-4000HC+卡
z 编码性能优化，全面提升图像质量，特别是4CIF的图像质量有很大提高
z DS-4000MD卡增加文
最低0.47元/天 解锁文章
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
