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，如需转载请自行联系原作者