海康威视设备网络sdk编程指南解码器)
DS-4100、4000HC系列板卡SDK编程指南_5.0
海康威视DS-4100、4000HC系列板卡SDK编程指南(For windows 2000/XP/2003/Vista)Version 5.02008-10目录板卡介绍篇 (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)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)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)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)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_SetV olume (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)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及OggV orbis(相当于G.722)的音频编码标准，完全依靠硬件实现了视频及音频的实时编码（CIF格式25帧PAL / 30帧NTSC）并精确同步，实现了动态码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警等功能，能独立调整各通道参数，性能稳定而且可靠。
海康解码器使用说明
2
DS-6401HD 用户下事项： 本设备上不能放置盛有液体的容器（例如花瓶）。 将设备放置在足够通风的空间并防止堵塞通风口。 检查电源电压，防止出现电压不配导致器件损坏。 使设备工作在技术指标允许的温度及湿度范围内。 水平放置，避免安装在剧烈震动的环境下。 电路板上的灰尘在受潮后会引起短路，为了使设备能长期正常工作，应该定期用刷子对电路板、接插 件、机箱风机、机箱等进行除尘。 从设备中取出电池前，请务必断开设备电源。 警告：电池更换不当会有爆炸危险，不建议用户直接更换；如需更换，只能用同样类型或等效类型的电 池进行更换。
DS-6401HD
视音频解码器
用户手册 V2.0.0
杭州海康威视数字技术股份有限公司 技术热线：400-700-5998 2010-9
1
DS-6401HD 用户手册
非常感谢您购买我公司的产品，如果您有什么疑问或需要请随时联系我们。 本手册适用于主控版本 V2.0.0、型号为 DS-6401HD 的视音频解码器。 本手册可能包含技术上不准确的地方、或与产品功能及操作不相符的地方、或印刷错误。我司将根据产 品功能的增强而更新本手册的内容， 并将定期改进或更新本手册中描述的产品或程序。 更新的内容将会在本 手册的新版本中加入，恕不另行通知。若存在手册中对产品的描述与实物不符，一律以实物为准
5
DS-6401HD 用户手册
第1章 产品概述
1.1 简介
DS-6401HD 视音频解码器是我公司基于 TI Davaci 平台开发的多功能视音频解码器， 用来将我公司硬盘 录像机和视频服务器等编码设备的编码图像， 通过网络解码后显示在电视墙上， 专为视频监控系统的部署与 管理而设计，支持多种网络传输协议，代码固化在系统 FLASH 中，系统运行稳定可靠。 DS-6401HD 采用集成度更高的 TI Davaci 处理芯片，解码引擎强劲，支持多种码流的传输方式，可对当 前高清 1080P 视频流进行解码输出，带有语音对讲和报警输入/输出等功能，为大型电视墙解码服务提供强 有力的支持。
海康威视解码器使用手册-V3.0
注意事项
·本设备上不能放置盛有液体的容器（例如花瓶）； ·将设备放置在足够通风的空间并防止堵塞通风口； ·检查电源电压，防止出现电压不配导致器件损坏； ·使设备工作在技术指标允许的温度及湿度范围内； ·水平放置，避免安装在剧烈震动的环境下； ·电路板上的灰尘在受潮后会引起短路，为了使设备能长期正常工作，应该定期用刷子对电
第 4 页 共 17 页
海康威视视频安防监控音视频解码器产品使用说明书
第一章 产品概述
杭州海康威视数字技术股份有限公司
1.1 产品概述
DS-600xD 解码器系列是专为视频监控系统的部署与管理而设计的网络解码器。DS-600xD 具有完善的网络功能，并且支持多种网络传输协议。DS-600xD 具有功能强大的解码引擎，支持多种编码格式。
2.2.1 标准 RS232 串口 RJ-45 插座引脚定义 .......................................................................................................................................................................... 8 2.2.2 标准 RS485 串口 RJ-45 插座引脚定义 .......................................................................................................................................................................... 9 2.2.3 10M/100M 自适应以太网口的双绞线制作 ..................................................................................................................................................................... 9 2.2.4 接线方法说明 .................................................................................................................................................................................................................. 9
海康客户端SDK使用手册V2.20
海康威视 DS-400xH 系列卡系统 SDK 说明书
海康威视DS-400xH系列卡系统SDK说明书（FOR LINUX）(2004-11-12 3.8版)海康威视DS-400xH是面向数字监控行业而推出的专用板卡，采用了高性能的视频压缩技术标准H.264及G.722的音频编码标准，完全依靠硬件实现了视频及音频的实时编码（CIF 格式25帧）并精确同步，实现了动态码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警、能独立调整各通道参数，性能稳定而且可靠。
与MPEG-I产品相比，在保持同等图像质量的前提下，能大大节省存储空间、并非常适合宽带网或窄带网的传输，是新一代数字监控产品的最佳选择。
海康威视DS-400xH系列卡SDK分为三部分，分别为系统SDK、网络SDK、播放SDK，本文档专门描述系统SDK，其他SDK请参照我公司相关文档。
系统SDK是专门为该系列一路及多路板卡设计的本地录像软件接口程序，以动态库的形式（libtmsdk.so）提供给应用软件开发者，并同时附有演示程序及其源码，能有效地缩短应用软件的开发周期。
在使用过程中，特别提醒软件开发人员，DS-400XH系列压缩卡可动态设置帧结构、帧率和图像质量，即在压缩过程中可改变帧率（SetIBPMode(…)）和量化系数（SetDefaultQuant）无须停止、启动压缩，还是保持同一数据流记录。
播放器会自动识别帧率等参数，按当前压缩帧率播放且声音播放保持正常。
通过动态修改量化系数（I、B、P）可控制压缩码率，当码率太高时，加大量化系数；当码率太低时，减少量化系数。
当然，在量化系数满足的情况下，不必再降低量化系数。
DS-400XH系列压缩卡的运动检测独立于压缩，不进行压缩也可以进行运动检测。
可动态改变帧率非常有价值，在运动时按25F/S录像，在无运动时按较低帧率录像，运动时按高帧帧率录像，记录在同一个文件内，可大大节省硬盘空间。
SetLogo(…)不仅可作LOGO使用，还可以用于遮盖图像中的某些区域。
海康威视解码器6400HD用户手册
杭州海康威视数字技术股份有限公司 | 版权所有（C）
DS-6400HD-T 系列多路高清解码器. 用户手册
3
目 录
第1章 1.1 1.2 2.1 2.2 3.1 3.2 4.1 产品概述 ........................................................................................................................................................................ 5 简介 ......................................................................................................................................................................................... 5 功能特性 ................................................................................................................................................................................. 5 设备外观 ................................................................................................................................................
海康SDK编程指南
海康SDK编程指南海康SDK编程指南目前使用的海康SDK包括IPC_SDK(硬件设备),Plat_SDK（平台），其中两套SDK都需单独调用海康播放库PlayCtrl.dll来解码视频流，返回视频信息和角度信息。
本文仅对视频监控常用功能的使用进行说明，其它未实现功能请参看设备网络SDK使用手册和播放库编程指南V7.2。
IPC_SDK编程指南(一) SDK的引用由于IPC_SDK没有SDK安装程序，所以需手工把下面图表中的DLL放入Debug或者Release文件夹的根目录下供程序调用，或者加入系统环境变量Path下。
名称版本号说明AudioIntercom.dll 1.1.0.5AudioRender.dll 1.0.0.2DsSdk.dll 6.0.10.922gdiplus.dll 微软库HCNetSDK.dll 4.3.0.6 网络功能调用，大量功能调用此库OpenAL32.dllPlayCtrl.dll 7.2.0.0 播放库，定制版本，增加返角回调及数据结构QosControl.dll 1.0.0.1StreamTransClient.dll 1.1.2.12SuperRender.dll 1.0.1.0SystemTransform.dll 2.4.0.3 设备信息转发，根据播放库修改过(二) C#程序调用DLL中的非托管函数方法1. 调用外部声明方法首先在C#语言源程序中声明外部方法，其基本形式是：[DLLImport(“DLL文件”)]修饰符 extern 返回变量类型方法名称（参数列表）例如：1 2 3 4 using System.Runtime.InteropServices;[DllImport("HCNetSDK.dll")]public static extern bool NET_DVR_Init();注意：1) 需要在程序声明中使用System.Runtime.InteropServices命名空间。
DS-4100、4000HC系列板卡SDK编程指南_5.0_1524
海康威视DS-4100、4000HC系列板卡SDK编程指南(For windows 2000/XP/2003/Vista)Version 5.0_15242009-4目录板卡介绍篇 (8)SDK版本更新篇 (10)错误代码及说明 (19)数据类型及数据结构定义 (21)API调用顺序 (23)函数说明篇 (26)1.板卡初始化及卸载 (26)1.1初始化DSP InitDSPs (26)1.2卸载DSP DeInitDSPs (26)2.板卡信息获取 (26)2.1获取系统中板卡的张数GetBoardCount (26)2.2获取系统中DSP的个数GetDspCount (26)2.3获取系统中编码通道的个数GetEncodeChannelCount (27)2.4获取系统中解码通道的个数GetDecodeChannelCount (27)2.5获取系统中解码显示通道的个数GetDisplayChannelCount (27)2.6获取板卡详细信息GetBoardDetail (27)2.7获取DSP详细信息GetDspDetail (28)2.8获取板卡型号及序列号信息GetBoardInfo (29)2.9获取板卡特殊功能信息GetCapability (29)2.10获取板卡SDK信息GetSDKVersion (30)3.编码卡API (30)3.1通道打开及关闭 (30)3.1.1打开通道ChannelOpen (30)3.1.2关闭通道ChannelClose (30)3.2视频预览 (31)3.2.1Overlay预览模式 (31)3.2.1.1设置视频预览模式SetPreviewOverlayMode (31)3.2.1.2设置overlay关键色SetOverlayColorKey (31)3.2.1.3恢复当前丢失的表面RestoreOverlay (31)3.2.2开启及停止视频预览 (32)3.2.2.1开启视频预览StartVideoPreview (32)3.2.2.2停止视频预览StopVideoPreview (32)3.2.3视频参数的设置及获取 (32)3.2.3.1设置视频参数SetVideoPara (32)3.2.3.2获取视频参数GetVideoPara (33)3.3视频信号设置（制式、状况、输入位置等） (33)3.3.1设置系统默认的视频制式SetDefaultVideoStandard (33)3.3.2设置视频信号灵敏度SetVideoDetectPrecision (33)3.3.3获取视频信号输入情况GetVideoSignal (34)3.3.4调整视频信号输入位置SetInputVideoPosition (34)3.3.5设置反隔行变换及强度SetDeInterlace (34)3.4视频编码参数设置 (35)3.4.1主、子通道切换SetupSubChannel (35)3.4.2获取双编码时数据流类型GetSubChannelStreamType (35)3.4.3编码流类型的设置及获取（不支持动态修改） (36)3.4.3.1设置主通道编码流类型SetStreamType (36)3.4.3.2获取主通道编码流类型GetStreamType (36)3.4.3.3设置子通道编码流类型SetSubStreamType (36)3.4.3.4获取子通道编码流类型GetSubStreamType (36)3.4.4（支持动态修改）的编码参数设置 (37)3.4.4.1设置编码图像质量SetDefaultQuant (37)3.4.4.2设置编码帧结构、帧率SetIBPMode (37)3.4.4.3设置编码分辨率 (37)3.4.4.3.1设置主通道分辨率SetEncoderPictureFormat (37)3.4.4.3.2设置子通道编码分辨率SetSubEncoderPictureFormat (38)3.4.4.4设置码率及码流控制模式 (38)3.4.4.4.1设置码流最大比特率SetupBitrateControl (38)3.4.4.4.2设置码流控制方式SetBitrateControlMode (38)3.4.5强制设定I帧CaptureIFrame (39)3.4.6获取帧统计信息GetFramesStatistics (39)3.5数据捕获 (39)3.5.1抓图（获取单帧图像数据） (39)3.5.1.1抓取BMP格式图像 (39)3.5.1.1.1获取原始yuv422格式数据GetOriginalImage (39)3.5.1.1.2图像格式转换YUVtoBMP SaveYUVToBmpFile (40)3.5.1.2抓取JPEG格式图像GetJpegImage (40)3.5.2原始图像数据流捕获（获取YUV420格式数据流） (40)3.5.2.1注册原始图像数据流回调函数RegisterImageStreamCallback (40)3.5.2.2开启及停止原始数据流捕获SetImageStream (41)3.5.3编码数据流捕获（获取编码后H.264格式数据流）即录像 (41)3.5.3.1编码数据流捕获方式设置 (41)3.5.3.1.1方式一、直接读取方式 (41)3.5.3.1.1.1注册编码图像数据流直接读取回调函数RegisterStreamDirectReadCallback (41)3.5.3.1.2方式二、消息读取方式 (42)3.5.3.1.2.1注册消息读取码流函数RegisterMessageNotifyHandle (42)3.5.3.1.3方式三、另一种直接读取方式 (42)3.5.3.1.3.1注册直接读取码流回调函数RegisterStreamReadCallback (42)3.5.3.2读取码流函数ReadStreamData (42)3.5.3.3开启及停止录像 (43)3.5.3.3.1启动主通道编码数据流捕获StartVideoCapture (43)3.5.3.3.2停止主通道编码数据流捕获StopVideoCapture (43)3.5.3.3.3启动子通道编码数据流捕获StartSubVideoCapture (43)3.5.3.3.4停止子通道编码数据流捕获StopSubVideoCapture (44)3.6移动侦测 (44)3.6.1设置方式一 (44)3.6.1.1设置移动侦测灵敏度AdjustMotionDetectPrecision (44)3.6.1.2设置移动侦测区域范围及个数SetupMotionDetection (45)3.6.1.3移动侦测分析MotionAnalyzer (45)3.6.2设置方式二 (45)3.6.2.1设置移动侦测（扩展）SetupMotionDetectionEx (45)3.6.3启动及停止移动侦测 (46)3.6.3.1启动移动侦测StartMotionDetection (46)3.6.3.2停止移动侦测StopMotionDetection (46)3.7视频信息叠加 (47)3.7.1信息叠入视频编码（OSD、LOGO、MASK） (47)3.7.1.1 OSD (47)3.7.1.1.1设置OSD显示模式SetOsdDisplayMode (47)3.7.1.1.2设置OSD显示模式（扩展）SetOsdDisplayModeEx (48)3.7.1.1.3设置OSD显示SetOsd (49)3.7.1.2 LOGO (49)3.7.1.2.1数据格式转换（bmp转yuv422）LoadYUVFromBmpFile (49)3.7.1.2.2设置LOGO显示模式SetLogoDisplayMode (50)3.7.1.2.3设置LOGO显示位置及数据SetLogo (50)3.7.1.2.4停止LOGO显示StopLogo (50)3.7.1.3视频遮挡MASK (51)3.7.1.3.1设置屏幕遮挡SetupMask (51)3.7.1.3.1停止屏幕遮挡StopMask (51)3.7.2仅在预览画面上叠加信息 (51)3.7.2.1注册画图回调函数RegisterDrawFun (51)3.7.2.2停止画图回调StopRegisterDrawFun (52)3.8音频 (52)3.8.1设置音频预览SetAudioPreview (52)3.8.2获取音频输入音量幅度GetSoundLevel (52)3.9其他 (52)3.9.1复位DSP ResetDSP** (52)3.9.2设置看门狗SetWatchDog (53)3.9.3码流数字水印校验 (53)3.9.3.1设置主通道数字水印校验SetChannelStreamCRC (53)3.9.3.2设置子通道数字水印校验SetSubChannelStreamCRC (53)4.解码卡API (54)4.1解码卡初始化及释放 (54)4.1.1初始化及释放解码卡 (54)4.1.1.1初始化解码卡HW_InitDecDevice (54)4.1.1.2释放解码卡HW_ReleaseDecDevice (54)4.1.2初始化及释放DirectDraw (54)4.1.2.1初始化DirectDraw HW_InitDirectDraw (54)4.1.2.2释放DirectDraw HW_ReleaseDirectDraw (55)4.1.3打开及关闭解码通道 (55)4.1.3.1打开解码通道HW_ChannelOpen (55)4.1.3.2.关闭解码通道HW_ChannelClose (55)4.2解码卡信息获取 (55)4.2.1版本信息获取HW_GetVersion (55)4.3解码卡音视频信号输出设置 (56)4.3.1音频输出设置 (56)4.3.1.1音频预览设置HW_SetAudioPreview (56)4.3.1.2音频模拟输出设置SetDecoderAudioOutput (56)4.3.2视频输出设置 (57)4.3.2.1视频制式设置 (57)4.3.2.1.1设置视频显示通道的视频制式SetDisplayStandard (57)4.3.2.2视频预览设置 (57)4.3.2.2.1设置视频显示参数HW_SetDisplayPara (57)4.3.2.2.2刷新overlay表面HW_RefreshSurface (57)4.3.2.2.3重载overlay表面HW_RestoreSurface (58)4.3.2.2.4清除overlay表面中的数据HW_ClearSurface (58)4.3.2.2.5缩放overlay表面的显示区域HW_ZoomOverlay (58)4.3.2.2.6预览去闪烁功能HW_SetDecoderPostProcess (58)4.3.2.3视频模拟输出显示区域设置 (59)4.3.2.3.1设置显示区域的形式及参数（视频模拟输出的画面分割情况）SetDisplayRegion (59)4.3.2.3.2改变某个显示区域的位置SetDisplayRegionPosition (59)4.3.2.3.3用自定义的图像填充显示区域FillDisplayRegion (60)4.3.2.3.4清空显示区域ClearDisplayRegion (60)4.3.3.4视频模拟输出设置 (60)4.3.3.4.1视频解码模拟输出（MD卡内部输出）SetDecoderVideoOutput (60)4.3.3.4.2视频解码通道模拟输出扩展（MD卡外部输出）SetDecoderVideoExtOutput (61)4.3.3.4.3视频编码通道模拟输出（MD卡外部输出）SetEncoderVideoExtOutput (61)4.3.3.4.4设置视频模拟输出亮度SetDisplayVideoBrightness (61)4.4解码卡解码及播放 (62)4.4.1解码卡数据解码方式设置（解码数据流、解码录像文件） (62)4.4.1.1解码卡解码数据流 (62)4.4.1.1.1打开数据流HW_OpenStream (62)4.4.1.1.2关闭数据流HW_CloseStream (62)4.4.1.1.3输入数据流HW_InputData (62)4.4.1.1.4流模式下重启解码器HW_ResetStream (62)4.4.1.2解码卡解码数据流功能扩展（以视、音频分开的形式） (63)4.4.1.2.1打开数据流HW_OpenStreamEx (63)4.4.1.2.2关闭数据流HW_CloseStreamEx (63)4.4.1.2.3输入视频数据流HW_InputVideoData (63)4.4.1.2.4输入音频数据流HW_InputAudioData (63)4.4.1.3解码卡解码录像文件 (64)4.4.1.3.1打开录像文件HW_OpenFile (64)4.4.1.3.2关闭录像文件HW_CloseFile (64)4.4.1.4设置及获取流播放参数 (64)4.4.1.4.1设置流播放模式及参数HW_SetStreamOpenMode (64)4.4.1.4.2获取流播放模式及参数HW_GetStreamOpenMode (64)4.4.2视音频播放 (65)4.4.2.1视频播放 (65)4.4.2.1.1开始视频播放HW_Play (65)4.4.2.1.2停止视频播放HW_Stop (65)4.4.2.2音频播放 (65)4.4.2.2.1打开声音HW_PlaySound (65)4.4.2.2.2关闭声音HW_StopSound (65)4.4.2.2.3音量调节HW_SetV olume (65)4.4.2.3暂停播放HW_Pause (66)4.4.3解码播放信息设置及获取 (66)4.4.3.1解码播放速度设置及获取 (66)4.4.3.1.1设置播放速度HW_SetSpeed (66)4.4.3.1.2获取播放速度HW_GetSpeed (66)4.4.3.2解码播放位置设置及获取 (67)4.4.3.2.1设置播放位置HW_SetPlayPos (67)4.4.3.2.2获取播放位置HW_GetPlayPos (67)4.4.3.3设置解码播放跳跃 (67)4.4.3.3.1设置播放跳跃时间间隔HW_SetJumpInterval (67)4.4.3.3.2设置播放跳跃方向HW_Jump (67)4.4.4解码时间及帧信息获取 (68)4.4.4.1时间信息获取 (68)4.4.4.1.1获取文件总时间HW_GetFileTime (68)4.4.4.1.2获取当前播放帧的时间（相对时间）HW_GetCurrentFrameTime (68)4.4.4.1.3获取文件的起止的绝对时间HW_GetFileAbsoluteTime (68)4.4.4.1.4获取文件当前播放的绝对时间HW_GetCurrentAbsoluteTime (68)4.4.4.1.5按照绝对时间定位文件播放位置HW_LocateByAbsoluteTime (69)4.4.4.2帧信息获取 (69)4.4.4.2.1获取文件总帧数HW_GetFileTotalFrames (69)4.4.4.2.2获取已解码的视频帧数HW_GetPlayedFrames (69)4.4.4.2.3获取当前播放帧率HW_GetCurrentFrameRate (69)4.4.4.2.4获取当前播放帧序号HW_GetCurrentFrameNum (70)4.4.4.2.5按照帧号定位文件播放位置HW_LocateByFrameNumber (70)4.5数据捕获 (70)4.5.1抓图 (70)4.5.1.1抓取MD卡解码后YV12格式图像HW_GetYV12Image (70)4.5.1.2图像格式转换（YV12转为BMP）HW_ConvertToBmpFile (70)4.5.2录像 (71)4.5.2.1启动码流捕获HW_StartCapFile (71)4.5.2.2停止码流捕获HW_StopCapFile (71)4.5.2.3获取码流中图像尺寸HW_GetPictureSize (71)4.5.3解码后原始数据流捕获（YUV420格式） (72)4.5.3.1 MD卡解码通道原始图像数据回调 (72)4.5.3.1.1注册解码通道数据流捕获回调函数RegisterDecoderVideoCaptureCallback (72)4.5.3.1.2设置解码通道数据流捕获函数HW_SetDecoderVideoCapture (72)4.5.3.2 MD卡显示通道原始图像数据回调 (73)4.5.3.2.1注册显示通道数据流捕获回调函数RegisterDisplayVideoCaptureCallback (73)4.5.3.2.2设置显示通道数据流捕获函数SetDisplayVideoCapture (73)4.6其他 (73)4.6.1文件结束标志HW_SetFileEndMsg (73)4.6.2文件索引 (74)4.6.2.1设置文件索引HW_SetFileRef (74)4.6.2.2文件索引导入HW_ImportFileRef (74)4.6.2.3文件索引导出HW_ExportFileRef (74)4.6.3解码画图回调（在offscreen预览模式下有效） (75)4.6.3.1注册解码画图回调函数HW_RegisterDrawFun (75)4.6.3.2停止解码画图回调函数HW_StopRegisterDrawFun (75)5.0版本SDK新增函数 (75)编码通道音频矩阵输出（内部输出）SetEncoderAudioOutput (75)编码通道音频矩阵输出（外部输出）SetEncoderAudioExtOutput (76)解码通道音频矩阵输出（外部输出）SetDecoderAudioExtOutput (76)函数索引（按英文字母排序） (77)附录 (79)板卡介绍篇海康威视DS-4100、4000HC系列是面向数字监控行业而推出的专用板卡，采用了高性能的视频压缩技术标准H.264及OggV orbis(相当于G.722)的音频编码标准，完全依靠硬件实现了视频及音频的实时编码（CIF格式25帧PAL / 30帧NTSC）并精确同步，实现了动态码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警等功能，能独立调整各通道参数，性能稳定而且可靠。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。