C# 视频监控系列(7):服务器端——封装API(下)(4)-阿里云开发者社区

开发者社区> 开发与运维> 正文
登录阅读全文

C# 视频监控系列(7):服务器端——封装API(下)(4)

简介:
 public static extern int SetIBPMode(IntPtr hChannelHandle, int KeyFrameIntervals, int BFrames, int PFrames, int FrameRate);

        
#region 3.4.4.3设置编码分辨率

        
/// <summary>
        
/// 3.4.4.3.1设置主通道分辨率SetEncoderPictureFormat
        
///     说 明:  设置主通道编码分辨率。支持动态修改。
        
/// 
        
/// int __stdcall SetEncoderPictureFormat(HANDLE hChannelHandle,  PictureFormat_t PictureFormat) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="PictureFormat">编码图像分辨率(4CIF、DCIF、2CIF、CIF、QCIF) </param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetEncoderPictureFormat(IntPtr hChannelHandle, PictureFormat_t PictureFormat);

        
/// <summary>
        
/// 3.4.4.3.2设置子通道编码分辨率SetSubEncoderPictureFormat
        
///     说 明:  设置双编码模式时子通道的编码分辨率,支持动态修改。
        
/// 
        
/// int __stdcall SetSubEncoderPictureFormat(HANDLE hChannelHandle,  PictureFormat_t PictureFormat) 
        
/// </summary>
        
/// <param name="hChannelHandle">子通道句柄</param>
        
/// <param name="PictureFormat">子通道编码图像分辨率(4CIF、DCIF、2CIF、CIF、 QCIF) </param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetSubEncoderPictureFormat(IntPtr hChannelHandle, PictureFormat_t PictureFormat);

        
#endregion

        
#region 3.4.4.4设置码率及码流控制模式

        
/// <summary>
        
/// 3.4.4.4.1设置码流最大比特率SetupBitrateControl 
        
///     说 明:  设置编码的最大比特率。设置为0时码流控制无效,设置为某一最大比特率时,
        
///     当编码码流超过该值时,DSP会自动调整编码参数来保证不超过最大比特率,当编码码流
        
///     低于最大比特率时,DSP不进行干涉。调整误差<10%
        /// 
        
/// int __stdcall SetupBitrateControl(HANDLE hChannelHandle, ULONG MaxBps) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="MaxBps">最大比特率。取值:10000以上</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetupBitrateControl(IntPtr hChannelHandle, ulong MaxBps);

        
/// <summary>
        
/// 3.4.4.4.2设置码流控制方式SetBitrateControlMode
        
///     说 明:   设置编码码流控制方式。配合SetupBitrateControl使用。当设置为变码率(brVBR) 
        
///     时,最大比特率将作为编码码流上限,由DSP在码流上限下自动控制码率,一般会自动回
        
///     落到最低的状态(由设定的图像质量参数和关键帧间隔决定),能最大程度地降低带宽和存
        
///     储空间,但存储容量一般难以估算;当设置为定码率(brCBR)时,以最大比特率作为编码
        
///     码率参数恒定输出码流,不会自动回落到低码流状态,存储容量可根据设定码率的大小进行估算。
        
/// 
        
/// int __stdcall SetBitrateControlMode(HANDLE hChannelHandle, BitrateControlType_t brc) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="brc">码流控制方式,分为变码率(brVBR)和恒定码率 (brCBR)两种方式 </param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetBitrateControlMode(IntPtr hChannelHandle, BitrateControlType_t brc);


        
#endregion

        
/// <summary>
        
/// 3.4.5强制设定I帧CaptureIFrame
        
///     说 明:  将当前编码帧强制设定为I帧模式,可从码流中提取该帧单独用于网络传送。
        
/// 
        
/// int __stdcall CaptureIFrame(HANDLE hChannelHandle)
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int CaptureIFrame(IntPtr hChannelHandle);

        
/// <summary>
        
/// 3.4.6获取帧统计信息GetFramesStatistics
        
///     说 明:  获取帧统计信息
        
/// 
        
/// int __stdcall GetFramesStatistics(HANDLE hChannelHandle,PFRAMES_STATISTICS framesStatistics) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="framesStatistics">帧统计信息</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int GetFramesStatistics(IntPtr hChannelHandle, PFRAMES_STATISTICS framesStatistics);

        
#endregion

        
#endregion

        
#region 3.5数据捕获

        
#region 3.5.1抓图(获取单帧图像数据)

        
#region 3.5.1.1抓取BMP格式图像

        
/// <summary>
        
/// 3.5.1.1.1获取原始yuv422格式数据GetOriginalImage
        
///     说 明:  获得原始yuv422格式图像,DS4000HC原始图像是4CIF图像格式(包括QCIF编码),
        
///     DS-4000HS原始图像为CIF图像格式,DS400xH卡的原始图象是CIF图象格式。
        
/// 
        
/// int __stdcall GetOriginalImage(HANDLE hChannelHandle, UCHAR *ImageBuf,  ULONG *Size) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="ImageBuf">原始yuv422格式图像指针</param>
        
/// <param name="Size">原始yuv422格式图像尺寸,函数调用前是ImageBuf的大小,调用后是实际图像所占用的字节数 </param>
        
/// <returns>成功返回0,失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int GetOriginalImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size);

        
/// <summary>
        
/// 3.5.1.1.2图像格式转换YUVtoBMP SaveYUVToBmpFile
        
///     说 明:  用户程序可调用此函数来生成24位的bmp文件,如果是DS4000HC卡抓图则
        
///     Width 为704,Height 为576PAL/480NTSC,如果是DS400xH卡抓图则Width可能为352 
        
///     或176,Height为288、240、144或120,要根据缓冲区的大小来判断。
        
/// 
        
/// int __stdcall SaveYUVToBmpFile(char *FileName, unsigned char *yuv, int Width, int Height) 
        
/// </summary>
        
/// <param name="FileName">文件名</param>
        
/// <param name="yuv">yuv422格式图像指针</param>
        
/// <param name="Width">图像宽度</param>
        
/// <param name="Height">图像高度</param>
        
/// <returns></returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SaveYUVToBmpFile(string FileName, byte[] yuv, int Width, int Height);

        
/// <summary>
        
/// 3.5.1.2抓取JPEG格式图像GetJpegImage
        
///     说 明:  抓取JPEG格式图像
        
/// 
        
/// int __stdcall GetJpegImage(HANDLE hChannelHandle,UCHAR *ImageBuf, ULONG *Size,UINT nQuality) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="ImageBuf">JPEG图像指针</param>
        
/// <param name="Size">JPEG图像尺寸,函数调用前是ImageBuf的大小,调用后是实际图像所占用的字节数 </param>
        
/// <param name="nQuality">JPEG图像质量,取值范围1-100,取值100时质量最好</param>
        
/// <returns></returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int GetJpegImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size, uint nQuality);

        
#endregion

        
#region 3.5.2原始图像数据流捕获(获取YUV420格式数据流)

        
/// <summary>
        
/// 3.5.2.1注册原始图像数据流回调函数RegisterImageStreamCallback
        
///     说 明:  注册获取原始图像数据流函数,用户可以获取实时的YUV420格式的预览数据
        
/// 
        
/// int __stdcall RegisterImageStreamCallback (IMAGE_STREAM_CALLBACK ImageStreamCallback,void *context) 
        
/// </summary>
        
/// <param name="ImageStreamCallback">原始图像数据流回调函数 </param>
        
/// <param name="context">设备上下文</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int RegisterImageStreamCallback(IMAGE_STREAM_CALLBACK ImageStreamCallback, IntPtr context);

        
/// <summary>
        
/// 3.5.2.2开启及停止原始数据流捕获SetImageStream
        
///     说明:    开启或停止原始图像数据流捕获,此函数依赖主机的处理速度。DS-4000HS只能捕获不大于CIF格式的数据流
        
/// 
        
/// 函 数:  int __stdcall SetImageStream(HANDLE hChannel,BOOL bStart,UINT fps, UINT width,UINT height,unsigned char *imageBuffer) 
        
/// </summary>
        
/// <param name="hChannel">通道句柄</param>
        
/// <param name="bStart">是否启动捕获</param>
        
/// <param name="fps">帧率</param>
        
/// <param name="width">图像宽度,必须是4CIF宽度的1/8,1/4,1/2或原始大小704</param>
        
/// <param name="height">图象高度,必须是4CIF高度的1/8,1/4,1/2或原始大小576PAL/480NTSC</param>
        
/// <param name="imageBuffer">数据存储缓存</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetImageStream(IntPtr hChannel, bool bStart, uint fps, uint width, uint height, char[] imageBuffer);

        
#endregion

        
#region 3.5.3编码数据流捕获(获取编码后H.264格式数据流)即录像

        
//注意:注册直接回调或者消息回调后,需要启动编码数据流捕获函数才能进行数据回调。三
        
//种数据回调方式,只需选取其中一种使用即可。对于HC系列板卡(包括HC、HC+、HCS、
        
//HS),推荐使用第一种读取方式。对于H系列板卡,只能使用后两种读取方式。

        
#region 3.5.3.1编码数据流捕获方式设置

        
/// <summary>
        
/// 3.5.3.1.1.1注册编码图像数据流直接读取回调函数
        
///     说 明:  DS4000HC系列板卡新增的一种数据流读取方式,当启动数据捕获后,   
        
///     StreamDirectReadCallback会提供数据流的地址、长度、帧类型等,供用户程序直接处理。
        
/// 
        
/// 函 数:  int __stdcall RegisterStreamDirectReadCallback (STREAM_DIRECT_READ_CALLBACK StreamDirectReadCallback,void *Context) 
        
/// </summary>
        
/// <param name="StreamDirectReadCallback">编码数据流直接读取回调函数</param>
        
/// <param name="context">设备上下文</param>
        
/// <returns>成功返回0;失败返回错误号</returns>

        [DllImport(
"DS40xxSDK.dll")]
        
public static extern int RegisterStreamDirectReadCallback(STREAM_DIRECT_READ_CALLBACK StreamDirectReadCallback, IntPtr context);

        
#endregion

        
#region 3.5.3.1.2方式二、消息读取方式

        
/// <summary>
        
/// 3.5.3.1.2.1设置消息读取伐值,此函数只对H卡有效
        
///     说 明:  设置消息读取的伐值,可以将缓冲区的数据在OnDataReady中一次性取走
        
/// 
        
/// int __stdcall SetupNotifyThreshold(HANDLE hChannelHandle,  int iFramesThreshold) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="iFramesThreshold">读取消息伐值,范围1-10</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetupNotifyThreshold(IntPtr hChannelHandle, int iFramesThreshold);

        
/// <summary>
        
/// 3.5.3.1.2.2注册消息读取码流函数
        
///     说 明:  当数据准备好时,SDK会向hWnd窗口发送MessageId消息,目标窗口收到
        
///     Message后调用ReadStreamData读取一帧数据。如果HC卡与H卡混插,可以先调用 
        
///     RegisterStreamDirectReadCallback函数来注册HC卡取码流回调函数,再调用
        
///     RegisterMessageNotifyHandle函数来注册H卡取码流消息函数。
        
///     HC系列板卡建议使用方式一进行数据捕获。 
        
/// 
        
/// int __stdcall RegisterMessageNotifyHandle(HWND hWnd, UINT MessageId)
        
/// </summary>
        
/// <param name="hWnd">通道句柄</param>
        
/// <param name="MessageId">自定义消息</param>
        
/// <returns>成功返回0;失败返回错误号 </returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int RegisterMessageNotifyHandle(IntPtr hWnd, uint MessageId);

        
#endregion

        
#region 3.5.3.1.3方式三、另一种直接读取方式

        
/// <summary>
        
/// 3.5.3.1.3.1注册直接读取码流回调函数
        
///     说 明:  另一种数据流读取方式
        
/// 
        
/// int __stdcall RegisterStreamReadCallback (STREAM_READ_CALLBACK StreamReadCallback, void *Context) 
        
/// </summary>
        
/// <param name="StreamReadCallback">直接读取码流回调函数</param>
        
/// <param name="Context">设备上下文</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int RegisterStreamReadCallback(STREAM_READ_CALLBACK StreamReadCallback, IntPtr Context);

        
#endregion

        
/// <summary>
        
/// 3.5.3.2读取码流函数
        
///     说 明:  读指定长度的数据流,适用于方式二及方式三。当调用StartVideoCapture 或
        
///     StartMotionDetection后,SDK线程会向已注册的用户窗口消息处理函数发送指定的消息,
        
///     并提供消息来源的通道号。当用户程序收到该消息时,可调用本函数来读取数据,Length 在
        
///     作为输入时必须提供缓冲的大小,ReadStreamData会判断缓冲是否足够,如果缓冲足够大
        
///     则返回值为当前的读取的帧长度,否则返回错误。
        
///         在HC卡中,如果已经先调用了RegisterStreamDirectReadCallback()函数,则不需调用 
        
///     ReadStreamData来读取数据,因为音视频数据会在RegisterStreamDirectReadCallback所注册
        
///     的回调函数中直接返回。
        
/// 
        
/// int __stdcall ReadStreamData(HANDLE hChannelHandle, void *DataBuf,  DWORD *Length, int *FrameType) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="DataBuf">自定义的数据缓存区</param>
        
/// <param name="Length">输入:缓存区的大小;输出:一帧数据的大小</param>
        
/// <param name="FrameType">帧类型</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int ReadStreamData(IntPtr hChannelHandle, byte[] DataBuf, out ulong Length, out int FrameType);

        
#region 3.5.3.3开启及停止录像

        
/// <summary>
        
/// 3.5.3.3.1启动主通道编码数据流捕获
        
///     说 明:  启动主通道编码数据流捕获。用户程序可以使用直接读取方式,使用
        
///     StreamDirectReadCallback回调函数直接对数据流进行处理;也可以与H卡一样,通过消息
        
///     读取方式,等SDK向用户程序发送在RegisterMessageNotifyHandle中注册的消息,用户程
        
///     序使用ReadStreamData来读取数据流。
        
/// 
        
/// int __stdcall StartVideoCapture(HANDLE hChannelHandle) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StartVideoCapture(IntPtr hChannelHandle);

        
/// <summary>
        
/// 3.5.3.3.2停止主通道编码数据流捕获
        
///     说 明:  停止主通道编码数据流捕获
        
/// 
        
/// int __stdcall StopVideoCapture(HANDLE hChannelHandle)
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StopVideoCapture(IntPtr hChannelHandle);

        
/// <summary>
        
/// 3.5.3.3.3启动子通道编码数据流捕获
        
///     说 明:  启动子通道编码数据流捕获 
        
/// 
        
/// int __stdcall StartSubVideoCapture(HANDLE hChannelHandle)
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StartSubVideoCapture(IntPtr hChannelHandle);


        
/// <summary>
        
/// 3.5.3.3.4停止子通道编码数据流捕获
        
///     说 明:  停止子通道编码数据流捕获
        
/// 
        
/// int __stdcall StopSubVideoCapture(HANDLE hChannelHandle) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号 </returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StopSubVideoCapture(IntPtr hChannelHandle);

        
#endregion

        
#endregion

        
#endregion

        
#endregion

        
#region 3.6移动侦测

        
//        释 义: 移动侦测 
        
//DS4000HC提供运动强度信息来处理运动检测,设置移动侦测区域时以32*32像素块为
        
//单位,按4CIF(704*576)分辨率计算,每行有22个块(704/32),PAL时18行(576/32),
        
//NTSC时15行(480/32),与编码格式无关。经过测试,这种方法比H卡提高了灵敏度和可
        
//靠性,并简化了返回的数据,返回的值是18个DWORD,对应屏幕高度576/32=18行(PAL),
        
//每个DWORD的0-21位对应屏幕宽度704/32=22, 其中1为运动,0为静止,也可以调用原有
        
//MotionAnalyzer分析结果 
        
//4.0版本的SDK新增了接口函数SetupMotionDetectionEx,提供了更灵活的功能,并且
        
//简化了用户的工作量。 

        
#region 3.6.1设置方式一

        
//        设置移动侦测相关参数并启动移动侦测后,运动检测信息会通过数据流传送,用户程序
        
//发现PktMotionDetection帧类型时,可调用MotionAnalyzer来处理运动信息,结果由
        
//MotionAnalyzer在iResult中返回。也可以按照SDK提供的数据格式来自己分析,运动信息格
        
//式参见移动侦测释义。 

        
/// <summary>
        
/// 3.6.1.1设置移动侦测灵敏度
        
///     说 明:  调整运动分析的灵敏度,支持动态调整,此函数决定DSP全局运动分析的灵敏度。
        
///     而MotionAnalyzer的iThreshold则主要用于分析指定区域的运动统计结果。
        
/// 
        
/// int __stdcall AdjustMotionDetectPrecision(HANDLE hChannelHandle, int iGrade, int iFastMotionDetectFps, int iSlowMotionDetectFps) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="iGrade">
        
///     运动分析灵敏度等级,取值范围0-6,0级最灵敏,6级最迟钝,推荐值为2。
        
///     将iGrade和“0x80000000“做”或“操作,会对移动侦测启用自适应分析。
        
/// </param>
        
/// <param name="iFastMotionDetectFps">高速运动检测的帧间隔,取值范围0-12,0表示不作高速运动检测,通常值取为2</param>
        
/// <param name="iSlowMotionDetectFps">低速运动检测的帧间隔,取值范围13以上,当取值为0时,不作低速运动检测</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]

        public static extern int AdjustMotionDetectPrecision(IntPtr hChannelHandle, int iGrade, int iFastMotionDetectFps, int iSlowMotionDetectFps);



本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/586683,如需转载请自行联系原作者

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章
最新文章
相关文章