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