视频监控 封装[PlayCtrl.dll]的API

 

前言

  PlayCtrl.dll都忘记到底是朋友翻的还是自己翻的了,有朋友需要,我就贴上来吧。

 

正文

  一、文件下载

    注意:文件可能随时更新,欢迎使用中遇到问题及时反馈给我。下载后把后缀改成.cs就行了。

    HikPlayer.txt

  二、部分API

    /// <summary>
    
/// 播放器
    
/// </summary>
    public sealed class HikPlayer
    {
        
#region Const Member Variables
        
// #define WINVER 
        
// 0x0700 Windows 7
        
// 0x0600 Windows Vista
        
// 0x0502 Windows 2003 Server
        
// 0x0410 Windows XP
        
//<0x0400 Windows 98/Windows 2000
        public static readonly int WINVER = 0x0502;

        
public static readonly uint WM_USER = 0x0400;
        
public static readonly uint WM_FILE_END = WM_USER + 33;
        
public static readonly uint WM_ENC_CHANGE = WM_USER + 100;
        
        
public static readonly int COLOR_DEFAULT = 64;
        
public static readonly int PLAYER_SLIDER_MAX = 200;
        
public static readonly int MAX_DISPLAY_DEVICE = 4;

        
public static readonly int WIDTH_PAL = 352;
        
public static readonly int HEIGHT_PAL = 288;

        
#region Source buffer
        
//#define SOURCE_BUF_MAX
        public static readonly uint SOURCE_BUF_MAX = 1024 * 100000;
        
//#define SOURCE_BUF_MIN    1024*50
        public static readonly uint SOURCE_BUF_MIN = 1024 * 50;
        
#endregion

        
#region Frame type
        
/// <summary>
        
/// 音频数据;采样率16khz,单声道,每个采样点16位表示。
        
/// </summary>
        public static readonly int T_AUDIO16 = 101;
        
public static readonly int T_AUDIO8 = 100;

        
/// <summary>
        
/// 视频数据,uyvy格式。“U0-Y0-V0-Y1-U2-Y2-V2-Y3….”,第一个像素位于图像左上角。 
        
/// </summary>
        public static readonly int T_UYVY = 1;
        
/// <summary>
        
/// 视频数据,yv12格式。排列顺序“Y0-Y1-……”,“V0-V1….”,“U0-U1-…..”。 
        
/// </summary>
        public static readonly int T_YV12 = 3;
        
/// <summary>
        
/// 视频数据。每个像素4个字节,排列方式与位图相似,“B-G-R-0 ……”,第一个像素位于图像左下角。 
        
/// </summary>
        public static readonly int T_RGB32 = 7;
        
#endregion

        
#region Stream type
        
/// <summary>
        
/// 实时模式,适合播放网络实时数据,解码器会立刻解码。
        
/// </summary>
        public static readonly int STREAME_REALTIME = 0;
        
/// <summary>
        
/// 文件模式,适合用户把文件数据用流方式输入。
        
/// 注意:当PlayM4_InputData()返回FALSE时,用户要等一下重新输入。
        
/// </summary>
        public static readonly int STREAME_FILE = 1;
        
#endregion

        
#region Error code
        
/// <summary>
        
/// 没有错误
        
/// no error
        
/// </summary>
        public static readonly int PlayM4_NOERROR = 0;
        
/// <summary>
        
/// 输入参数非法
        
/// input parameter is invalid;
        
/// </summary>
        public static readonly int PlayM4_PARA_OVER = 1;
        
/// <summary>
        
/// 调用顺序不对
        
/// The order of the function to be called is error.
        
/// </summary>
        public static readonly int PlayM4_ORDER_ERROR = 2;
        
/// <summary>
        
/// 多媒体时钟设置失败
        
/// Create multimedia clock failed;
        
/// </summary>
        public static readonly int PlayM4_TIMER_ERROR = 3;
        
/// <summary>
        
/// 视频解码失败
        
/// Decode video data failed.
        
/// </summary>
        public static readonly int PlayM4_DEC_VIDEO_ERROR = 4;
        
/// <summary>
        
/// 音频解码失败
        
/// Decode audio data failed.
        
/// </summary>
        public static readonly int PlayM4_DEC_AUDIO_ERROR = 5;
        
/// <summary>
        
/// 分配内存失败
        
/// Allocate memory failed.
        
/// </summary>
        public static readonly int PlayM4_ALLOC_MEMORY_ERROR = 6;
        
/// <summary>
        
/// 文件操作失败
        
/// Open the file failed.
        
/// </summary>
        public static readonly int PlayM4_OPEN_FILE_ERROR = 7;
        
/// <summary>
        
/// 创建线程事件等失败
        
/// Create thread or event failed.
        
/// </summary>
        public static readonly int PlayM4_CREATE_OBJ_ERROR = 8;
        
/// <summary>
        
/// 创建DirectDraw失败
        
/// Create DirectDraw object failed.
        
/// </summary>
        public static readonly int PlayM4_CREATE_DDRAW_ERROR = 9;
        
/// <summary>
        
/// 创建后端缓存失败
        
/// Failed when creating off-screen surface.
        
/// </summary>
        public static readonly int PlayM4_CREATE_OFFSCREEN_ERROR = 10;
        
/// <summary>
        
/// 缓冲区满,输入流失败
        
/// Buffer is overflow.
        
/// </summary>
        public static readonly int PlayM4_BUF_OVER = 11;
        
/// <summary>
        
/// 创建音频设备失败
        
/// Failed when creating audio device.
        
/// </summary>
        public static readonly int PlayM4_CREATE_SOUND_ERROR = 12;
        
/// <summary>
        
/// 设置音量失败
        
/// Set volume failed.
        
/// </summary>
        public static readonly int PlayM4_SET_VOLUME_ERROR = 13;
        
/// <summary>
        
/// 只能在播放文件时才能使用此接口
        
/// The function only support play file.
        
/// </summary>
        public static readonly int PlayM4_SUPPORT_FILE_ONLY = 14;
        
/// <summary>
        
/// 只能在播放流时才能使用此接口
        
/// The function only support play stream.
        
/// </summary>
        public static readonly int PlayM4_SUPPORT_STREAM_ONLY = 15;
        
/// <summary>
        
/// 系统不支持,解码器只能工作在Pentium 3以上
        
/// System not support.
        
/// </summary>
        public static readonly int PlayM4_SYS_NOT_SUPPORT = 16;
        
/// <summary>
        
/// 没有文件头
        
/// No file header.
        
/// </summary>
        public static readonly int PlayM4_FILEHEADER_UNKNOWN = 17;
        
/// <summary>
        
/// 解码器和编码器版本不对应
        
/// The version of decoder and encoder is not adapted.  
        
/// </summary>
        public static readonly int PlayM4_VERSION_INCORRECT = 18;
        
/// <summary>
        
/// 初始化解码器失败
        
/// Initialize decoder failed.
        
/// </summary>
        public static readonly int HIK_PALYM4_INIT_DECODER_ERROR = 19;
        
/// <summary>
        
/// 文件太短或码流无法识别
        
/// The file data is unknown.
        
/// </summary>
        public static readonly int PlayM4_CHECK_FILE_ERROR = 20;
        
/// <summary>
        
/// 初始化多媒体时钟失败
        
/// Initialize multimedia clock failed.
        
/// </summary>
        public static readonly int PlayM4_INIT_TIMER_ERROR = 21;
        
/// <summary>
        
/// 位拷贝失败
        
/// Blt failed.
        
/// </summary>
        public static readonly int PlayM4_BLT_ERROR = 22;
        
/// <summary>
        
/// 显示Overlay失败
        
/// Update failed.
        
/// </summary>
        public static readonly int PlayM4_UPDATE_ERROR = 23;
        
/// <summary>
        
/// 打开文件错误
        
/// Open file error, stream type is multi.
        
/// </summary>
        public static readonly int PlayM4_OPEN_FILE_ERROR_MULTI = 24;
        
/// <summary>
        
/// 打开文件错误
        
/// Open file error, stream type is video.
        
/// </summary>
        public static readonly int PlayM4_OPEN_FILE_ERROR_VIDEO = 25;
        
/// <summary>
        
/// JPEG格式压缩错误
        
/// JPEG compress error.
        
/// </summary>
        public static readonly int PlayM4_JPEG_COMPRESS_ERROR = 26;
        
/// <summary>
        
/// 不支持此文件的版本
        
/// Don't support the version of this file.
        
/// </summary>
        public static readonly int PlayM4_EXTRACT_NOT_SUPPORT = 27;
        
/// <summary>
        
/// 提取视频数据失败
        
/// Extract video data failed.
        
/// </summary>
        public static readonly int PlayM4_EXTRACT_DATA_ERROR = 28;

        
#endregion

        
#region Display buffers
        
/// <summary>
        
/// 播放缓冲最大值
        
/// </summary>
        public static readonly int MAX_DIS_FRAMES = 50;
        
/// <summary>
        
/// 播放缓冲最小值
        
/// </summary>
        public static readonly int MIN_DIS_FRAMES = 6;
        
#endregion

        
#region Locate by
        
/// <summary>
        
/// 帧号
        
/// </summary>
        public static readonly int BY_FRAMENUM = 1;
        
/// <summary>
        
/// 时间
        
/// </summary>
        public static readonly int BY_FRAMETIME = 2;
        
#endregion

        
#region Display type
        
/// <summary>
        
/// 正常分辨率数据送显卡显示。
        
/// </summary>
        public static readonly int DISPLAY_NORMAL = 1;
        
/// <summary>
        
/// 1/4分辨率数据送显卡显示。
        
/// </summary>
        public static readonly int DISPLAY_QUARTER = 2;
        
#endregion

        
#region Timer type
        
/// <summary>
        
/// 一个进程中只能使用16个,定时比较准,画面流畅。
        
/// Only 16 timers for every process.Default TIMER;
        
/// </summary>
        public static readonly int TIMER_1 = 1;
        
/// <summary>
        
/// 使用数目没有限制,定时没有TIMER_1准。
        
/// Not limit;But the precision less than TIMER_1; 
        
/// </summary>
        public static readonly int TIMER_2 = 2;
        
#endregion

        
#region BUFFER TYPE
        
/// <summary>
        
/// 视频数据源缓冲区,缓冲解码之前视频数据,只对流模式有效,单位byte。
        
/// </summary>
        public static readonly ushort BUF_VIDEO_SRC = 1;
        
/// <summary>
        
/// 音频数据源缓冲区,缓冲解码之前音频数据,只对流模式有效, 单位byte。 
        
/// </summary>
        public static readonly ushort BUF_AUDIO_SRC = 2;
        
/// <summary>
        
/// 解码后视频数据缓冲区,单位帧数。 
        
/// </summary>
        public static readonly ushort BUF_VIDEO_RENDER = 3;
        
/// <summary>
        
/// 解码后音频数据缓冲区,单位帧数,音频40ms数据定为一帧。 
        
/// </summary>
        public static readonly ushort BUF_AUDIO_RENDER = 4;
        
#endregion

        
#endregion

        
#region HikPlayer
        
/// <summary>
        
/// 1、 BOOL PlayM4_InitDDraw(HWND hWnd);
        
/// 初始化DirectDraw表面。在使用vb,delphi开发时请注意,它们生成的对话框具有WS_CLIPCHILDREN
        
/// 窗口风格,必须去掉这种风格,否则显示画面会被对话框上的控件覆盖。注意:1.1版以上不需要调用。
        
/// </summary>
        
/// <param name="hWnd">hWnd 应用程序主窗口的句柄。</param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_InitDDraw(IntPtr hWnd);

        
/// <summary>
        
/// 2、 BOOL PlayM4_RealeseDDraw(); 
        
/// 释放directDraw表面;注意:1.1版以上不需要调用。
        
/// </summary>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_RealeseDDraw();

        
/// <summary>
        
/// 3、 BOOL PlayM4_OpenFile(LONG nPort,LPSTR sFileName); 
        
/// 打开播放文件
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <param name="sFileName">文件名,文件不能超过4G或小于4K</param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_OpenFile(int nPort, string sFileName);

        
/// <summary>
        
/// 4、 BOOL PlayM4_CloseFile(LONG nPort); 
        
/// 关闭播放文件
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_CloseFile(int nPort);

        
/// <summary>
        
/// 5、 BOOL PlayM4_Play(LONG nPort, HWND hWnd); 
        
/// 播放开始,播放视频画面大小将根据hWnd窗口调整,要全屏显示,只要把hWnd窗口放大到全屏。
        
/// 如果已经播放,只是改变当前播放速度为正常速度。 
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <param name="hWnd">hWnd 播放视频的窗口句柄</param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_Play(int nPort, IntPtr hWnd);

        
/// <summary>
        
/// 6、 BOOL PlayM4_Stop(LONG nPort); 
        
/// 播放结束
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_Stop(int nPort);

        
/// <summary>
        
/// 7、 BOOL PlayM4_Pause(LONG nPort,DWORD nPause); 
        
/// 播放暂停/恢复
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <param name="nPause">nPause=TRUE暂停,否则恢复</param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_Pause(int nPort, bool nPause);

        
/// <summary>
        
/// 8、 BOOL PlayM4_Fast(LONG nPort); 
        
/// 快速播放,每次调用将使当前播放速度加快一倍,最多调用4次;要恢复正常播放调用PlayM4_Play(),
        
/// 从当前位置开始正常播放
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_Fast(int nPort);

        
/// <summary>
        
/// 9、 BOOL PlayM4_Slow(LONG nPort); 
        
/// 慢速播放,每次调用将使当前播放速度慢一倍;最多调用4次;要恢复正常播放调用PlayM4_Play()
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_Slow(int nPort);

        
/// <summary>
        
/// 10、BOOL PlayM4_SetPlayPos(LONG nPort,float fRelativePos); 
        
/// 设置文件播放指针的相对位置(百分比)。 
        
/// </summary>
        
/// <param name="nPort"></param>
        
/// <param name="fRelativePos">范围0-100%</param>
        
/// <returns></returns>
        [DllImport("PlayCtrl.dll")]
        
public static extern bool PlayM4_SetPlayPos(int nPort, float fRelativePos);


结束语

  最近学习C++,所积累的还没达到可以写文章的水平,所以近段时间的文章会比较少。

posted @ 2010-03-12 09:33  农民伯伯  阅读(10904)  评论(14编辑  收藏  举报