天天看点

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

一、文件下载

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

二、部分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;

        /// 视频数据,uyvy格式。“U0-Y0-V0-Y1-U2-Y2-V2-Y3….”,第一个像素位于图像左上角。 

        public static readonly int T_UYVY = 1;

        /// 视频数据,yv12格式。排列顺序“Y0-Y1-……”,“V0-V1….”,“U0-U1-…..”。 

        public static readonly int T_YV12 = 3;

        /// 视频数据。每个像素4个字节,排列方式与位图相似,“B-G-R-0 ……”,第一个像素位于图像左下角。 

        public static readonly int T_RGB32 = 7;

        #region Stream type

        /// 实时模式,适合播放网络实时数据,解码器会立刻解码。

        public static readonly int STREAME_REALTIME = 0;

        /// 文件模式,适合用户把文件数据用流方式输入。

        /// 注意:当PlayM4_InputData()返回FALSE时,用户要等一下重新输入。

        public static readonly int STREAME_FILE = 1;

        #region Error code

        /// 没有错误

        /// no error

        public static readonly int PlayM4_NOERROR = 0;

        /// 输入参数非法

        /// input parameter is invalid;

        public static readonly int PlayM4_PARA_OVER = 1;

        /// 调用顺序不对

        /// The order of the function to be called is error.

        public static readonly int PlayM4_ORDER_ERROR = 2;

        /// 多媒体时钟设置失败

        /// Create multimedia clock failed;

        public static readonly int PlayM4_TIMER_ERROR = 3;

        /// 视频解码失败

        /// Decode video data failed.

        public static readonly int PlayM4_DEC_VIDEO_ERROR = 4;

        /// 音频解码失败

        /// Decode audio data failed.

        public static readonly int PlayM4_DEC_AUDIO_ERROR = 5;

        /// 分配内存失败

        /// Allocate memory failed.

        public static readonly int PlayM4_ALLOC_MEMORY_ERROR = 6;

        /// 文件操作失败

        /// Open the file failed.

        public static readonly int PlayM4_OPEN_FILE_ERROR = 7;

        /// 创建线程事件等失败

        /// Create thread or event failed.

        public static readonly int PlayM4_CREATE_OBJ_ERROR = 8;

        /// 创建DirectDraw失败

        /// Create DirectDraw object failed.

        public static readonly int PlayM4_CREATE_DDRAW_ERROR = 9;

        /// 创建后端缓存失败

        /// Failed when creating off-screen surface.

        public static readonly int PlayM4_CREATE_OFFSCREEN_ERROR = 10;

        /// 缓冲区满,输入流失败

        /// Buffer is overflow.

        public static readonly int PlayM4_BUF_OVER = 11;

        /// 创建音频设备失败

        /// Failed when creating audio device.

        public static readonly int PlayM4_CREATE_SOUND_ERROR = 12;

        /// 设置音量失败

        /// Set volume failed.

        public static readonly int PlayM4_SET_VOLUME_ERROR = 13;

        /// 只能在播放文件时才能使用此接口

        /// The function only support play file.

        public static readonly int PlayM4_SUPPORT_FILE_ONLY = 14;

        /// 只能在播放流时才能使用此接口

        /// The function only support play stream.

        public static readonly int PlayM4_SUPPORT_STREAM_ONLY = 15;

        /// 系统不支持,解码器只能工作在Pentium 3以上

        /// System not support.

        public static readonly int PlayM4_SYS_NOT_SUPPORT = 16;

        /// 没有文件头

        /// No file header.

        public static readonly int PlayM4_FILEHEADER_UNKNOWN = 17;

        /// 解码器和编码器版本不对应

        /// The version of decoder and encoder is not adapted.  

        public static readonly int PlayM4_VERSION_INCORRECT = 18;

        /// 初始化解码器失败

        /// Initialize decoder failed.

        public static readonly int HIK_PALYM4_INIT_DECODER_ERROR = 19;

        /// 文件太短或码流无法识别

        /// The file data is unknown.

        public static readonly int PlayM4_CHECK_FILE_ERROR = 20;

        /// 初始化多媒体时钟失败

        /// Initialize multimedia clock failed.

        public static readonly int PlayM4_INIT_TIMER_ERROR = 21;

        /// 位拷贝失败

        /// Blt failed.

        public static readonly int PlayM4_BLT_ERROR = 22;

        /// 显示Overlay失败

        /// Update failed.

        public static readonly int PlayM4_UPDATE_ERROR = 23;

        /// 打开文件错误

        /// Open file error, stream type is multi.

        public static readonly int PlayM4_OPEN_FILE_ERROR_MULTI = 24;

        /// Open file error, stream type is video.

        public static readonly int PlayM4_OPEN_FILE_ERROR_VIDEO = 25;

        /// JPEG格式压缩错误

        /// JPEG compress error.

        public static readonly int PlayM4_JPEG_COMPRESS_ERROR = 26;

        /// 不支持此文件的版本

        /// Don't support the version of this file.

        public static readonly int PlayM4_EXTRACT_NOT_SUPPORT = 27;

        /// 提取视频数据失败

        /// Extract video data failed.

        public static readonly int PlayM4_EXTRACT_DATA_ERROR = 28;

        #region Display buffers

        /// 播放缓冲最大值

        public static readonly int MAX_DIS_FRAMES = 50;

        /// 播放缓冲最小值

        public static readonly int MIN_DIS_FRAMES = 6;

        #region Locate by

        /// 帧号

        public static readonly int BY_FRAMENUM = 1;

        /// 时间

        public static readonly int BY_FRAMETIME = 2;

        #region Display type

        /// 正常分辨率数据送显卡显示。

        public static readonly int DISPLAY_NORMAL = 1;

        /// 1/4分辨率数据送显卡显示。

        public static readonly int DISPLAY_QUARTER = 2;

        #region Timer type

        /// 一个进程中只能使用16个,定时比较准,画面流畅。

        /// Only 16 timers for every process.Default TIMER;

        public static readonly int TIMER_1 = 1;

        /// 使用数目没有限制,定时没有TIMER_1准。

        /// Not limit;But the precision less than TIMER_1; 

        public static readonly int TIMER_2 = 2;

        #region BUFFER TYPE

        /// 视频数据源缓冲区,缓冲解码之前视频数据,只对流模式有效,单位byte。

        public static readonly ushort BUF_VIDEO_SRC = 1;

        /// 音频数据源缓冲区,缓冲解码之前音频数据,只对流模式有效, 单位byte。 

        public static readonly ushort BUF_AUDIO_SRC = 2;

        /// 解码后视频数据缓冲区,单位帧数。 

        public static readonly ushort BUF_VIDEO_RENDER = 3;

        /// 解码后音频数据缓冲区,单位帧数,音频40ms数据定为一帧。 

        public static readonly ushort BUF_AUDIO_RENDER = 4;

        #region HikPlayer

        /// 1、 BOOL PlayM4_InitDDraw(HWND hWnd);

        /// 初始化DirectDraw表面。在使用vb,delphi开发时请注意,它们生成的对话框具有WS_CLIPCHILDREN

        /// 窗口风格,必须去掉这种风格,否则显示画面会被对话框上的控件覆盖。注意:1.1版以上不需要调用。

        /// <param name="hWnd">hWnd 应用程序主窗口的句柄。</param>

        /// <returns></returns>

        [DllImport("PlayCtrl.dll")]

        public static extern bool PlayM4_InitDDraw(IntPtr hWnd);

        /// 2、 BOOL PlayM4_RealeseDDraw(); 

        /// 释放directDraw表面;注意:1.1版以上不需要调用。

        public static extern bool PlayM4_RealeseDDraw();

        /// 3、 BOOL PlayM4_OpenFile(LONG nPort,LPSTR sFileName); 

        /// 打开播放文件

        /// <param name="nPort"></param>

        /// <param name="sFileName">文件名,文件不能超过4G或小于4K</param>

        public static extern bool PlayM4_OpenFile(int nPort, string sFileName);

        /// 4、 BOOL PlayM4_CloseFile(LONG nPort); 

        /// 关闭播放文件

        public static extern bool PlayM4_CloseFile(int nPort);

        /// 5、 BOOL PlayM4_Play(LONG nPort, HWND hWnd); 

        /// 播放开始,播放视频画面大小将根据hWnd窗口调整,要全屏显示,只要把hWnd窗口放大到全屏。

        /// 如果已经播放,只是改变当前播放速度为正常速度。 

        /// <param name="hWnd">hWnd 播放视频的窗口句柄</param>

        public static extern bool PlayM4_Play(int nPort, IntPtr hWnd);

        /// 6、 BOOL PlayM4_Stop(LONG nPort); 

        /// 播放结束

        public static extern bool PlayM4_Stop(int nPort);

        /// 7、 BOOL PlayM4_Pause(LONG nPort,DWORD nPause); 

        /// 播放暂停/恢复

        /// <param name="nPause">nPause=TRUE暂停,否则恢复</param>

        public static extern bool PlayM4_Pause(int nPort, bool nPause);

        /// 8、 BOOL PlayM4_Fast(LONG nPort); 

        /// 快速播放,每次调用将使当前播放速度加快一倍,最多调用4次;要恢复正常播放调用PlayM4_Play(),

        /// 从当前位置开始正常播放

        public static extern bool PlayM4_Fast(int nPort);

        /// 9、 BOOL PlayM4_Slow(LONG nPort); 

        /// 慢速播放,每次调用将使当前播放速度慢一倍;最多调用4次;要恢复正常播放调用PlayM4_Play()

        public static extern bool PlayM4_Slow(int nPort);

        /// 10、BOOL PlayM4_SetPlayPos(LONG nPort,float fRelativePos); 

        /// 设置文件播放指针的相对位置(百分比)。 

        /// <param name="fRelativePos">范围0-100%</param>

        public static extern bool PlayM4_SetPlayPos(int nPort, float fRelativePos);

继续阅读