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

 #region 3.7.1.2 LOGO

        
/// <summary>
        
/// 3.7.1.2.1数据格式转换
        
///     说 明:  将24位bmp格式图像转换为yuv422格式图像。
        
///     注意:bmp位图的长宽必须为16的倍数,图像尺寸最大支持128*128,4.3版本SDK图像尺寸扩大为256*128
        
/// 
        
/// 函 数:  int __stdcall LoadYUVFromBmpFile(char *FileName, unsigned char *yuv,  int BufLen, int *Width, int *Height) 
        
/// </summary>
        
/// <param name="FileName">文件名</param>
        
/// <param name="yuv">YUV422图像指针 </param>
        
/// <param name="BufLen">YUV422图像缓存大小</param>
        
/// <param name="Width">返回的YUV422图像的宽度</param>
        
/// <param name="Height">返回的YUV422图像的高度</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int LoadYUVFromBmpFile(string FileName, string yuv, int BufLen, ref int Width, ref int Height);

        
/// <summary>
        
/// 3.7.1.2.2设置LOGO显示模式
        
///     说 明:  设置LOGO显示模式
        
/// 
        
/// 函 数:  int __stdcall SetLogoDisplayMode(HANDLE hChannelHandle,  COLORREF ColorKey, BOOL Translucent, int TwinkleInterval) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="ColorKey">LOGO图像中该颜色在显示时将会全透明</param>
        
/// <param name="Translucent">LOGO图像是否作半透明处理</param>
        
/// <param name="TwinkleInterval">闪烁的时间设置,由16进制数表示为0xXXYY,其中XX为显示的秒数,YY为停止的秒数,XXYY均为0时正常显示。</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetLogoDisplayMode(IntPtr hChannelHandle, Color ColorKey, bool Translucent, int TwinkleInterval);

        
/// <summary>
        
/// 3.7.1.2.3设置LOGO显示位置及数据
        
///     说 明:  设置LOGO图像位置及数据,用户程序可先调用LoadYUVFromBmpFile将24
        
///     位bmp文件中转化为YUV422格式数据,,透明处理由DSP完成。
        
///     注意:HS卡的x,w需要按照32对齐,y,h仍为8对齐。
        
/// 
        
/// 函 数:  int __stdcall SetLogo(HANDLE hChannelHandle, int x, int y, int w, int h,  unsigned char *yuv) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="x">LOGO左上角x坐标位置,取值范围0-703,需按16对齐</param>
        
/// <param name="y">LOGO左上角y坐标位置,取值范围0-575,需按8对齐</param>
        
/// <param name="w">LOGO宽度,最大值为256,需按16对齐,此宽度必须和LOGO图片的宽度相一致</param>
        
/// <param name="h">LOGO高度,最大值为128,需按8对齐</param>
        
/// <param name="yuv">LOGO图片指针(yuv422格式)</param>
        
/// <returns>成功返回0;失败返回错误号 </returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetLogo(IntPtr hChannelHandle, int x, int y, int w, int h, string yuv);

        
/// <summary>
        
/// 3.7.1.2.4停止LOGO显示
        
///     说 明:  停止LOGO显示
        
/// 
        
/// int __stdcall StopLogo(HANDLE hChannelHandle)
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StopLogo(IntPtr hChannelHandle);

        
#endregion

        
#region 3.7.1.3视频遮挡MASK

        
/// <summary>
        
/// 3.7.1.3.1设置屏幕遮挡
        
///     说 明:  设置屏幕遮挡,最多可以设置32个
        
/// 
        
/// int __stdcall SetupMask(HANDLE hChannelHandle, RECT *RectList, int iAreas) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="RectList">矩形框数组,宽度范围0-704,按16对齐;高度范围0-576,按</param>
        
/// <param name="iAreas">矩形框个数</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetupMask(IntPtr hChannelHandle, ref Rectangle RectList, int iAreas);

        
/// <summary>
        
/// 3.7.1.3.1停止屏幕遮挡
        
///     说 明:  停止屏幕遮挡
        
/// 
        
/// int __stdcall StopMask(HANDLE hChannelHandle) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StopMask(IntPtr hChannelHandle);

        
#endregion

        
#endregion

        
#region 3.7.2仅在预览画面上叠加信息

        
//        注意:当采用overlay预览模式时,可在overlay表面上直接叠加字符或画图,当采用offscreen
        
//预览模式时,需要调用画图回调函数进行信息叠加,所叠加信息仅在预览屏幕上显示,不进
        
//入编码。 

        
//Offscreen预览模式下画图回调函数

        
/// <summary>
        
/// 3.7.2.1注册画图回调函数
        
///     说 明:  获取当前offscreen表面的device context,HC系列板卡采用创建offscreen的方 
        
///     式,所以在窗口客户区中的DC中无法画图或者鞋子,必须使用DirectDraw里的offscreen表面的DC。
        
///     注意:如果采用overlay预览模式,则直接在overlay表面画图即可,无需调用此函数
        
/// 
        
/// int __stdcall RegisterDrawFun(DWORD nport, DRAWFUN(DrawFun),LONG nUser)
        
/// </summary>
        
/// <param name="nport">通道号索引</param>
        
/// <param name="df">画图回调函数</param>
        
/// <param name="nUser">用户数据</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int RegisterDrawFun(ulong nport, DrawFun df, long nUser);
        
//public static extern int RegisterDrawFun(ulong nport, DrawFun df, IntPtr nUser);

        
/// <summary>
        
/// 3.7.2.2停止画图回调
        
///     说 明:  停止画图回调。在某些显卡上进行画图回调,会使得CPU的利用率变高,所以可以在适当的时候(画图回调结束)停止调用。
        
/// 
        
/// int __stdcall StopRegisterDrawFun(DWORD nport) 
        
/// </summary>
        
/// <param name="nport">通道索引</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int StopRegisterDrawFun(ulong nport);



        
#endregion

        
#endregion

        
#region 3.8音频

        
/// <summary>
        
/// 3.8.1设置音频预览
        
///     说 明:  设置音频预览与否,同一时间,系统只支持一路音频预览。需要将4针线和声卡音频输入口联接。
        
/// 
        
/// int __stdcall SetAudioPreview(HANDLE hChannelHandle, BOOL bEnable) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <param name="bEnable">使能</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetAudioPreview(IntPtr hChannelHandle, bool bEnable);

        
/// <summary>
        
/// 3.8.2获取音频输入音量幅度
        
///     说 明:  获取当前通道的现场声音幅度。
        
///     注意:当无声音输入时因背景噪声的原因返回值并不为0。 
        
/// 
        
/// int __stdcall GetSoundLevel(HANDLE hChannelHandle) 
        
/// </summary>
        
/// <param name="hChannelHandle">通道句柄</param>
        
/// <returns>当前通道的音频输入幅度</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int GetSoundLevel(IntPtr hChannelHandle);


        
#endregion

        
#region 3.9其他

        
/// <summary>
        
/// 3.9.1复位DSP
        
///     此函数目前无效
        
///     说 明:  复位某个DSP,注意请谨慎调用该函数,请确定DSP故障无法软件恢复时再关闭相关的资源后复位DSP。
        
/// 
        
/// int __stdcall ResetDSP(int DspNumber);
        
/// </summary>
        
/// <param name="DspNumber">DSP索引号</param>
        
/// <returns>  成功返回0;失败返回错误号 </returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int ResetDSP(int DspNumber);

        
/// <summary>
        
/// 3.9.2设置看门狗
        
///     说 明:  设置看门狗。DS-4016HCS提供4pin复位接口,用户需要把主机机箱的Reset
        
///     接线连接到板卡上相邻的2pin复位接口,板卡上的另外相邻的2pin接口连接到主板的Reset,
        
///     这样就可以实现对上层软件和系统中所有压缩板卡的运行状态监控。
        
/// 
        
/// int __stdcall SetWatchDog(UINT boardNumber,BOOL bEnable) 
        
/// </summary>
        
/// <param name="boardNumber">板卡索引</param>
        
/// <param name="bEnable">使能</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetWatchDog(uint boardNumber, bool bEnable);

        
#region 3.9.3码流数字水印校验

        
/// <summary>
        
/// 3.9.3.1设置主通道数字水印校验
        
///     说 明:  此函数不支持动态设置,设置后会在下一次启动录像后生效。
        
/// 
        
/// int __stdcall SetChannelStreamCRC(HANDLE hChannel,BOOL bEnable) 
        
/// </summary>
        
/// <param name="hChannel">通道句柄</param>
        
/// <param name="bEnable">使能</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetChannelStreamCRC(IntPtr hChannel, bool bEnable);

        
/// <summary>
        
/// 3.9.3.2设置子通道数字水印校验
        
///     说 明:  此函数不支持动态设置,设置后会在下一次启动录像后生效。
        
/// 
        
/// int __stdcall SetSubChannelStreamCRC(HANDLE hChannel,BOOL bEnable)
        
/// </summary>
        
/// <param name="hChannel">通道句柄</param>
        
/// <param name="bEnable">使能</param>
        
/// <returns>成功返回0;失败返回错误号</returns>
        [DllImport("DS40xxSDK.dll")]
        
public static extern int SetSubChannelStreamCRC(IntPtr hChannel, bool bEnable);


        
#endregion

        
#endregion

        
#endregion

    }
}

 

 

修改记录

     1.     2009-3-16,修改前本文备份:/Files/over140/2009/3/2009-3-16.rar

          1.1     去掉了《4.解码卡API 》,暂时用不上也占文章太多行数,暂时去掉了。

          1.2     GetSDKVersion 结构体一般需要加ref

               VC++:int __stdcall GetSDKVersion(PVERSION_INFO VersionInfo)

               C#[改前]:public static extern int GetSDKVersion(PVERSION_INFO VersionInfo);

               C#[改后]:public static extern int GetSDKVersion(ref PVERSION_INFO VersionInfo);

          1.3     抓图函数GetJpegImage ,没注意参数Size前面的*

               VC++:int __stdcall GetJpegImage(HANDLE hChannelHandle,UCHAR *ImageBuf, ULONG *Size,UINT nQuality)

               C#[改前]:public static extern int GetJpegImage(IntPtr hChannelHandle, byte[] ImageBuf, ulong Size, uint nQuality);

               C#[改后]:public static extern int GetJpegImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size, uint nQuality); 

          1.4     抓图函数GetOriginalImage,没注意参数Size前面的*

               VC++:int __stdcall GetOriginalImage(HANDLE hChannelHandle, UCHAR *ImageBuf,  ULONG *Size) 

               C#[改前]:public static extern int GetOriginalImage(IntPtr hChannelHandle, byte[] ImageBuf, ulong Size);

               C#[改后]:public static extern int GetOriginalImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size);

          小节:一般结构体对应翻译的话都要加ref;一般数值类型的加*对应都要加out。 

     2.     2009-3-19

          2.1     GetBoardDetail

                    VC++原型:int __stdcall GetBoardDetail(UINT boardNum,DS_BOARD_DETAIL *pBoardDetail)

                    C# 改前:public static extern int GetBoardDetail(uint boardNum, DS_BOARD_DETAIL pBoardDetail);

                    C# 改后:public static extern int GetBoardDetail(uint boardNum, ref DS_BOARD_DETAIL pBoardDetail);

          2.2     GetDspDetail

                    VC++原型:int __stdcall GetDspDetail(UINT dspNum,DSP_DETAIL *pDspDetail)

                    C# 改前:public static extern int GetDspDetail(uint dspNum, DSP_DETAIL pDspDetail);

                    C# 改后:public static extern int GetDspDetail(uint dspNum, ref DSP_DETAIL pDspDetail);

 

结束

     在后续的文章中本文中API仍然可能会变动,毕竟我们用的只是其中的一部分,我会随时更新,感谢继续关注。本来是作为一篇文章发布的,发现代码过长,插入都费老半天,所有拆开成上下了!!



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

上一篇:大厂微服务架构的负载均衡算法是如何选型的?


下一篇:Windows下如何查看某个端口被谁占用