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);