视频监控 封装[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++，所积累的还没达到可以写文章的水平，所以近段时间的文章会比较少。