C# 视频监控系列（11）：H264播放器――封装API[HikPlayM4.dll] (6)

/// 注册一个回调函数，获得当前表面的device context, 你可以在这个DC上画图（或写字），就好
        /// 像在窗口的客户区DC上绘图，但这个DC不是窗口客户区的DC，而是DirectDraw里的
        /// Off-Screen表面的DC。注意，如果是使用overlay表面，这个接口无效，你可以直接在窗口上绘图，只要不是透明色就不会被覆盖。 
        /// 
        /// 75．BOOL __stdcall Hik_PlayM4_RigisterDrawFun(LONG nPort,void (CALLBACK* DrawFun)(long nPort,HDC hDc,LONG nUser),LONG nUser); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="df">回调函数句柄。 </param>
        /// <param name="nUser">用户数据</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_RigisterDrawFun(int nPort, DrawFun df, int nUser);

        /// <summary>
        /// 获取文件索引信息，以便下次打开同一个文件时直接使用这个信息。必须在索引建成后才能获得信息。 
        /// 
        /// 76．BOOL __stdcall Hik_PlayM4_GetRefValue(LONG nPort,BYTE *pBuffer, DWORD *pSize); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="pBuffer">索引信息</param>
        /// <param name="pSize">
        ///     输入/输出参数：输入pBuffer的大小，输出索引信息大小。
        ///     注：可以在第一次指定pSize=0,pBuffer=NULL
        ///     从pSize的返回值获得需要的缓冲区大小。然后分配足够的缓冲，再调用一次 
        /// </param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetRefValue(int nPort, IntPtr pBuffer, ref ushort pSize);


        /// <summary>
        /// 设置文件索引。如果已经有了文件索引信息，可以不再调用生成索引的回调函数(53.Hik_PlayM4_SetFileRefCallBack)，直接输入索引信息。
        ///     注：索引信息及其长度必须准确 
        /// 
        /// 77．BOOL __stdcall Hik_PlayM4_SetRefValue(LONG nPort,BYTE *pBuffer, DWORD nSize); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="pBuffer">索引信息。</param>
        /// <param name="nSize">索引信息的长度</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetRefValue(int nPort, IntPtr pBuffer, ushort nSize);


        /// <summary>
        /// 设置播放器使用的定时器；注意：必须在Open之前调用
        /// 
        /// 78．BOOL __stdcall Hik_PlayM4_SetTimerType(LONG nPort,DWORD nTimerType,DWORD nReserved); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nTimerType">TIMER_1或TIMER_2，见宏定义。默认情况下0~15路使用TIMER_1，其余使用TIMER_2。</param>
        /// <param name="nReserved">保留</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetTimerType(int nPort, ushort nTimerType, ushort nReserved);

        /// <summary>
        /// 获得当前通道使用的定时器。 
        /// 
        /// 79．BOOL __stdcall Hik_PlayM4_GetTimerType(LONG nPort,DWORD *pTimerType,DWORD *pReserved); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="pTimerType">TIMER_1或TIMER_2</param>
        /// <param name="pReserved">保留</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetTimerType(int nPort, out ushort pTimerType, out ushort pReserved);

        /// <summary>
        /// 清空播放器中的缓冲区。
        /// 
        /// 80．BOOL __stdcall Hik_PlayM4_ResetBuffer(LONG nPort,DWORD nBufType); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nBufType">缓冲区类型</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_ResetBuffer(int nPort, int nBufType);

        #endregion

        /// <summary>
        /// 获取播放器中的缓冲区大小（帧数或者byte）。这个接口可以帮助用户了解缓冲区中的数据，从而在网络延时方面有所估计。 
        /// 
        /// 81．DWORD __stdcall Hik_PlayM4_GetBufferValue(LONG nPort,DWORD nBufType); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nBufType">缓冲区类型</param>
        /// <returns>根据参数不同，返回缓冲区值，源缓冲区返回byte,解码后缓冲区返回帧数。</returns>
        [DllImport("HikPlayM4.dll")]
        public static extern ushort Hik_PlayM4_GetBufferValue(int nPort, ushort nBufType);

        /// <summary>
        /// 调整WAVE波形，可以改变声音的大小。它和Hik_PlayM4_SetVolume的不同在于，它是调整声音数据，
        /// 只对该路其作用，而Hik_PlayM4_SetVolume是调整声卡音量，对整个系统起作用。
        ///     注意，用这个函数会破坏音质，除非想每路单独调整音量，否则请谨慎使用。 
        /// 
        /// 82．BOOL __stdcall Hik_PlayM4_AdjustWaveAudio(LONG nPort,LONG nCoefficient); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nCoefficient">调整的参数，范围从MIN_WAVE_COEF 到 MAX_WAVE_COEF，0是不调整。</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_AdjustWaveAudio(int nPort, int nCoefficient);


        /// <summary>
        /// 注册一个回调函数，校验数据是否被修改，实现水印功能。现在可以发现数据丢失情况。
        ///     注意，该校验在建立文件索引的时候进行，所以必须建文件索引才能校验。在openfile之前使用。 
        /// 
        /// 83．BOOL __stdcall Hik_PlayM4_SetVerifyCallBack(LONG nPort, DWORD nBeginTime, DWORD nEndTime, void (__stdcall* funVerify)(long nPort, FRAME_POS * pFilePos, DWORD bIsVideo, DWORD nUser),  DWORD  nUser); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nBeginTime">校验开始时间，单位ms</param>
        /// <param name="nEndTime">校验结束时间，单位ms</param>
        /// <param name="vfy">当发现数据被修改时回调的函数</param>
        /// <param name="nUser">用户数据</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetVerifyCallBack(int nPort, uint nBeginTime, uint nEndTime, Verify vfy, uint nUser);

        /// <summary>
        /// 音频帧解码后的wave数据回调
        /// 
        /// 84．BOOL __stdcall Hik_PlayM4_SetAudioCallBack(LONG nPort, void (__stdcall * funAudio)(long nPort, char * pAudioBuf, long nSize, long nStamp, long nType, long nUser), long nUser); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nBufType"></param>
        /// <param name="ado">音频回调函数</param>
        /// <param name="nUser">用户自定义数据</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetAudioCallBack(int nPort, Audio ado, int nUser);

        /// <summary>
        /// 解码时图象格式发生改变通知用户的回调函数；在打开文件前使用
        /// 
        /// 85. BOOL __stdcall Hik_PlayM4_SetEncTypeChangeCallBack(LONG nPort,void(CALLBACK *funEncChange)(long nPort,long nUser),long nUser); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="ec">回调函数</param>
        /// <param name="nUser">用户自定义数据</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetEncTypeChangeCallBack(int nPort, EncChange ec, int nUser);

        /// <summary>
        /// 设置图象的视频参数，即时起作用
        ///     注意： 如果全部为默认值将不进行颜色调节
        /// 
        /// 86．BOOL __stdcall Hik_PlayM4_SetColor(LONG nPort, DWORD nRegionNum, int nBrightness, int nContrast, int nSaturation, int nHue); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nRegionNum">显示区域，参考Hik_PlayM4_SetDisplayRegion；如果只有一个显示区域(通常情况)设为0</param>
        /// <param name="nBrightness">亮度，默认64； 范围0-128</param>
        /// <param name="nContrast">对比度，默认64； 范围0-128</param>
        /// <param name="nSaturation">饱和度，默认64； 范围0-128</param>
        /// <param name="nHue">色调，默认64； 范围0-128</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetColor(int nPort, ushort nRegionNum, int nBrightness, int nContrast, int nSaturation, int nHue);


        /// <summary>
        /// 相应的获得颜色值，参数同上
        /// 
        /// 87．BOOL __stdcall Hik_PlayM4_GetColor(LONG nPort, DWORD nRegionNum, int *pBrightness, int *pContrast, int *pSaturation, int *pHue); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="nRegionNum">显示区域，参考Hik_PlayM4_SetDisplayRegion；如果只有一个显示区域(通常情况)设为0</param>
        /// <param name="nBrightness">亮度，默认64； 范围0-128</param>
        /// <param name="nContrast">对比度，默认64； 范围0-128</param>
        /// <param name="nSaturation">饱和度，默认64； 范围0-128</param>
        /// <param name="nHue">色调，默认64； 范围0-128</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetColor(int nPort, ushort nRegionNum, out int pBrightness, out int pContrast, out int pSaturation, out int pHue);

        /// <summary>
        /// 设置解码时编码格式发生改变时要发送的消息。 
        /// 
        /// 88．BOOL __stdcall Hik_PlayM4_SetEncChangeMsg(LONG nPort,HWND hWnd,UINT nMsg) 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="hWnd">消息发送的窗口。</param>
        /// <param name="nMsg">用户输入的消息，当设置解码时编码格式发生改变时要发送此定义的消息。消息函数中的wParam参数值是返回nPort的值。 </param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetEncChangeMsg(int nPort, IntPtr hWnd, uint nMsg);


        /// <summary>
        /// 创建得到原始帧数据的回调函数，可以改变每帧的时标和帧号，在文件打开之后调用。用于将两个文件拼接在一起。
        /// 
        /// 89. BOOL _stdcall Hik_PlayM4_GetOriginalFrameCallBack(LONG nPort, BOOL bIsChange, BOOL bNormalSpeed, long nStartFrameNum, long nStartStamp, long nFileHeader, void(CALLBACK *funGetOrignalFrame)(long nPort,FRAME_TYPE *frameType, long nUser), long nUser) 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="bIsChange">是否要改变每帧的参数</param>
        /// <param name="bNormalSpeed">是否要以正常速度得到原始帧</param>
        /// <param name="nStartFrameNum">如要改变原始帧帧号，则是此文件的开始帧号</param>
        /// <param name="nStartStamp">如要改变原始帧时标，则是此文件的开始时标</param>
        /// <param name="nFileHeader">输出参数:文件头版本信息，如果版本不匹配，返回不成功</param>
        /// <param name="gof"></param>
        /// <param name="nUser">用户数据</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetOriginalFrameCallBack(int nPort, bool bIsChange, bool bNormalSpeed, int nStartFrameNum, int nStartStamp, out int nFileHeader, GetOrignalFrame gof, int nUser);


        /// <summary>
        /// 得到文件最后的时标和帧号，在文件打开之后调用。与上个文件一起使用，用于文件拼接。 
        /// 
        /// 90．BOOL _stdcall Hik_PlayM4_GetFileSpecialAttr(LONG nPort, DWORD *pTimeStamp,DWORD *pFileNum ,DWORD *nFileHeader) 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="pTimeStamp">文件结束时标</param>
        /// <param name="pFileNum">文件结束帧号</param>
        /// <param name="nFileHeader">文件头信息</param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetFileSpecialAttr(int nPort, ref ushort pTimeStamp, ref ushort pFileNum, ref ushort nFileHeader);

        #region 以下为4.7版(build0711)新增接口

        /// <summary>
        /// 抓图存为JPEG文件, 该函数可在显示回调函数中使用, 用法参见Hik_PlayM4_ConvertToBmpFile(); 
        /// 
        /// 91. BOOL _stdcall Hik_PlayM4_ConvertToJpegFile(char *pBuf, long nSize, long nWidth, int nHeight, long nType, char *sFileName) 
        /// </summary>
        /// <param name="pBuf">图像数据缓存</param>
        /// <param name="nSize">图像大小</param>
        /// <param name="nWidth">图像宽</param>
        /// <param name="nHeight">图像高</param>
        /// <param name="nType">图像类型YV12</param>
        /// <param name="sFileName">保存jpeg文件路径 </param>
        /// <returns>
        ///     TRUE: 保存Jpeg文件成功
        ///      FALSE: 失败, 可调用Hik_PlayM4_GetLastError()获取错误类型 
        /// </returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_ConvertToJpegFile(byte[] pBuf, int nSize, int nWidth, int nHeight, int nType, string sFileName);

        /// <summary>
        /// 设置抓取的jpeg图像质量, 设置范围0~100, 建议使用75~90, 若不调用该函数, 则采用默认图像质量, 目前默认为80 
        /// 
        /// 92. BOOL _stdcall Hik_PlayM4_SetJpegQuality(long nQuality) 
        /// </summary>
        /// <param name="nQuality">
        ///     质量参数, 范围0~100
        ///     0:   图像质量最差, 但抓取的图像大小最小 
        ///     100: 图像质量最好, 但抓取的图像大小最大 
        /// </param>
        /// <returns>
        ///     TRUE: 设置成功, 采用设置的质量
        /// FALSE: 设置失败, 采用默认值, 可调用Hik_PlayM4_GetLastError()获取错误类型 
        ///     </returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetJpegQuality(int nQuality);

        /// <summary>
        /// 设置是否去闪烁功能, 原先在静止图像区域有噪声情况下, 图像会产生闪烁现象（或称刷新或跳动），
        /// 启动去闪烁功能后，闪烁效果可消除或减轻，同时也能降低噪声 
        /// 
        /// 93. BOOL _stdcall Hik_PlayM4_SetDeflash(LONG nPort,BOOL bDeflash) 
        /// </summary>
        /// <param name="nPort">通道号</param>
        /// <param name="bDeflash"> TRUE表示设置去闪烁，FALSE表示不设置，默认为不设置</param>
        /// <returns>TRUE: 设置成功；FALSE: 设置失败, 采用默认值, 可调用Hik_PlayM4_GetLastError()获取错误类型 </returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetDeflash(int nPort, bool bDeflash);

        #endregion

        #region 以下为4.8版(build0813)新增接口

        /// <summary>
        /// 帧号不连续时是否跳下一个I帧
        /// 
        /// 94. BOOL __stdcall Hik_PlayM4_CheckDiscontinuousFrameNum(LONG nPort, BOOL bCheck)
        /// </summary>
        /// <param name="nPort">通道号</param>
        /// <param name="bCheck">帧号不连续时是否跳下一个I帧</param>
        /// <returns>TRUE:  设置成功  FALSE: 设置失败 </returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_CheckDiscontinuousFrameNum(int nPort, bool bCheck);

        /// <summary>
        /// 抓取bmp图像 
        /// 
        /// 95. BOOL __stdcall Hik_PlayM4_GetBMP(LONG nPort,PBYTE pBitmap,DWORD nBufSize,DWORD* pBmpSize); 
        /// </summary>
        /// <param name="nPort">通道号</param>
        /// <param name="pBitmap">
        ///     存放BMP图像数据地址，由用户分配，不得小于bmp图像大小
        ///     sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + w * h * 4， 其中w和h分别为图像宽高。 
        /// </param>
        /// <param name="nBufSize">申请的缓冲区大小</param>
        /// <param name="pBmpSize">获取到的实际bmp图像大小</param>
        /// <returns>TRUE:  获取成功 FALSE: 获取失败 </returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetBMP(int nPort, string pBitmap, ushort nBufSize, out ushort pBmpSize);

        /// <summary>
        /// 抓取jpeg图像 
        /// 
        /// 96. BOOL __stdcall Hik_PlayM4_GetJPEG(LONG nPort,PBYTE pJpeg,DWORD nBufSize,DWORD* pJpegSize); 
        /// </summary>
        /// <param name="nPort">通道号</param>
        /// <param name="pJpeg">存放JEPG图像数据地址，由用户分配，不得小于JPEG图像大小，建议大小w * h * 3/2， 其中w和h分别为图像宽高。</param>
        /// <param name="nBufSize">申请的缓冲区大小。</param>
        /// <param name="pJpegSize">获取到的实际bmp图像大小。</param>
        /// <returns>TRUE:   获取成功  FALSE:  获取失败</returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_GetJPEG(int nPort, string pJpeg, ushort nBufSize, out ushort pJpegSize);

        /// <summary>
        ///  设置回调函数，替换播放器中的显示部分，有用户自己控制显示，该函数在Hik_PlayM4_Play之前调用，
        ///  在Hik_PlayM4_Stop时自动失效，下次调用Hik_PlayM4_Play之前需要重新设置。
        ///  注意解码部分不控制速度，只要用户从回调函数中返回，解码器就会解码下一部分数据。这个功能
        ///  的使用需要用户对视频显示和声音播放有足够的了解，否则请慎重使用，有关知识请参阅directx开发包。
        /// 
        /// 97. BOOL __stdcall Hik_PlayM4_SetDecCallBackMend(LONG nPort,void (CALLBACK* DecCBFun)(long nPort,char * pBuf,long nSize,FRAME_INFO * pFrameInfo, long nUser, long nReserved2), long nUser); 
        /// </summary>
        /// <param name="nPort"></param>
        /// <param name="dcbf">DecCBFun回调函数指针，不能为NULL</param>
        /// <param name="nUser"></param>
        /// <returns></returns>
        [DllImport("HikPlayM4.dll")]
        public static extern bool Hik_PlayM4_SetDecCallBackMend(int nPort, DecCBFun dcbf, int nUser);


        #endregion

    }
}

 

 

 

结束

     和前面一样注意API可能存在误差，随后的文章将保持本文的更新！！