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

/// <summary>

/// 设置回调函数，替换播放器中的显示部分，有用户自己控制显示，该函数在Hik_PlayM4_Play

/// 之前调用，在Hik_PlayM4_Stop时自动失效，下次调用Hik_PlayM4_Play之前需要重新设

/// 置。注意解码部分不控制速度，只要用户从回调函数中返回，解码器就会解码下一部分数据。这个

/// 功能的使用需要用户对视频显示和声音播放有足够的了解，否则请慎重使用，有关知识请参阅directx开发包。

///

/// 24 ． BOOL Hik_PlayM4_SetDecCallBack(LONG nPort,void (CALLBACK* DecCBFun)(long nPort,char * pBuf,long nSize,FRAME_INFO * pFrameInfo, long nReserved1,long nReserved2));

/// </summary>

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

/// <param name="dcbf">DecCBFun回调函数指针，不能为NULL</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetDecCallBack(int nPort, DecCBFun dcbf);

/// <summary>

/// 设置抓图回调函数；注意要尽快返回，如果要停止回调，可以把回调函数指针DisplayCBFun设为NULL。

/// 一旦设置回调函数，则一直有效，直到程序退出。该函数可以在任何时候调用。

///

/// 25 ． BOOL Hik_PlayM4_SetDisplayCallBack(LONG nPort,void (CALLBACK* DisplayCBFun)(long nPort,char * pBuf,long nSize,long nWidth,long nHeight,long nStamp,long nType,long nReceaved));

/// </summary>

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

/// <param name="dcbf">DisplayCBFun抓图回调函数，可以为NULL。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetDisplayCallBack(int nPort, DisplayCBFun dcbf);

/// <summary>

/// 将抓图得到的图像数据保存成BMP文件。转换函数占用的cpu资源，如果不需要保存图片，则不要调用

///

/// 26．BOOL Hik_PLayM4_ConvertToBmpFile(char * pBuf,long nSize,long nWidth,long 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">同抓图回调函数中的参数</param>

/// <param name="sFileName">要保存的文件名。最好以BMP作为文件扩展名。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PLayM4_ConvertToBmpFile(IntPtr pBuf, int nSize, int nWidth, int nHeight, int nType, string sFileName);

/// <summary>

/// 得到文件中的总帧数。

///

/// 27．DWORD Hik_PlayM4_GetFileTotalFrames(LONG nPort);

/// </summary>

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

/// <returns>文件中的总帧数。 </returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetFileTotalFrames(int nPort);

/// <summary>

/// 得到当前码流中编码时的帧率。

///

/// 28．DWORD Hik_PlayM4_GetCurrentFrameRate(LONG nPort);

/// </summary>

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

/// <returns>当前码流中编码时的帧率。 </returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetCurrentFrameRate(int nPort);

/// <summary>

/// 得到文件当前播放的时间，单位毫秒

///

/// 29．DWORD Hik_PlayM4_GetPlayedTimeEx(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetPlayedTimeEx(int nPort);

/// <summary>

/// 根据时间设置文件播放位置，此接口比Hik_PlayM4_SetPlayPos费时，但如果用时间来控制播放进度条

/// （与Hik_PlayM4_GetPlayedTime(Ex)配合使用），那么可以使进度条平滑滚动。

///

/// 30．BOOL Hik_PlayM4_SetPlayedTimeEx(LONG nPort,DWORD nTime);

/// </summary>

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

/// <param name="nTime">设置文件播放位置到指定时间。单位毫秒。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetPlayedTimeEx(int nPort, ushort nTime);

/// <summary>

/// 得到当前播放的帧序号，。而Hik_PlayM4_GetPlayedFrames是总共解码的帧数。如果文件播放位置

/// 不被改变，那么这两个函数的返回值应该非常接近，除非码流丢失数据。

///

/// 31．DWORD Hik_PlayM4_GetCurrentFrameNum(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetCurrentFrameNum(int nPort);

/// <summary>

/// 设置流播放的模式。必须在播放之前设置。

/// 注意：2.2版以后可以做暂停，快放，慢放，单帧播放操作。

///

/// 32．BOOL Hik_PlayM4_SetStreamOpenMode(LONG nPort,DWORD nMode);

/// </summary>

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

/// <param name="nMode">STREAME_REALTIME实时模式（默认），STREAME_FILE文件模式。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetStreamOpenMode(int nPort, ushort nMode);

/// <summary>

/// 得到当前版本播放器能播放的文件的文件头长度。 主要应用在流播放器的STREAME_FILE模式下。

/// 以便读出文件头作为Hik_PlayM4_OpenStream()的输入参数。

///

/// 33．DWORD Hik_PlayM4_GetFileHeadLength();

/// <example>

/// CFile m_TestFile;

/// void Start()

/// {

/// //获得文件头长度；

/// DWORD nLength= Hik_PlayM4_GetFileHeadLength();

/// PBYTE pFileHead=new BYTE[nLength];

/// //打开文件；

/// m_TestFile.Open("test.mp4 ", CFile::modeRead,NULL);

/// m_TestFile.Read(pFileHead,nLength);

/// //设置模式

/// Hik_PlayM4_SetStreamOpenMode(0,STREAME_FILE);

/// //打开流接口

/// if(!Hik_PlayM4_OpenStream(0,pFileHead, nLength,1024*100))

/// {

/// m_strPlayFileName="";

/// MessageBox("文件打不开");

/// }

/// //播放

/// m_bPlaying = Hik_PlayM4_Play( 0, m_hWnd);

/// delete []pFileHead;

///}

/// ///////////////////////////////////////////////////////////////////////////////

/// void InputData()

/// {

///BYTE pBuf[4096];

/// m_TestFile.Read(pBuf,sizeof(pBuf));

/// while(!Hik_PlayM4_InputData(0,pBuf,sizeof(pBuf)))

/// }

/// {

/// if(!m_bPlaying)

/// break;//如果已经停止播放，则退出；

/// TRACE("SLEEEP \n");

/// Sleep(5);

/// }

/// }

/// </example>

/// </summary>

/// <returns>此版本播放器对应的文件头的长度。 </returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetFileHeadLength();

/// <summary>

/// 得到当前播放器sdk的版本号和build号。如果只是修改bug，我们只升级build号。

///

/// 34．DWORD Hik_PlayM4_GetSdkVersion();

/// </summary>

/// <returns>高16位表示当前的build号。9~16位表示主版本号，1~8位表示次版本号。如：返回值0x06040105 表示：build号是0604，版本号1.5。 </returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_GetSdkVersion();

/// <summary>

/// 获得当前错误的错误码。用户应该在调用某个函数失败时，调用此函数以获得错误的详细信息。

///

/// 35．DWORD Hik_PlayM4_GetLastError(LONG nPort)

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_GetLastError(int nPort);

/// <summary>

/// 刷新显示。当用户暂停时如果刷新了窗口，则窗口中的图像因为刷新而消失，此时调用这个接口可

/// 以重新把图像显示出来。只有在暂停和单帧播放时才会执行， 其它情况会直接返回。

///

/// 36．BOOL Hik_PlayM4_RefreshPlay(LONG nPort)

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_RefreshPlay(int nPort);

/// <summary>

/// 设置OVERLAY模式显示画面。在一块显卡中同一时刻只能有一个OVERLAY表面处于活动状态，

/// 如果此时系统中已经有程序使用了OVERLAY，那么播放器就不能再创建OVERLAY表面，它将自

/// 动改用Off_Screen表面，并不返回FALSE。一些常用的播放器，以及我们卡的预览都可能使用了

/// overlay表面。同样，如果播放器使用了OVERLAY表面，那么，其他的程序将不能使用OVERLAY

/// 表面，特别注意，我们的卡在预览时可能也要使用OVERLAY(用户可设置)，如果先打开播放器（并

/// 且使用了OVERLAY），再启动预览，那么预览可能因为得不到OVERLAY而失败。使用OVERLAY

/// 模式的优点是：大部份的显卡都支持OVERLAY，在一些不支持BLT硬件缩放和颜色转换的显卡上

/// (如SIS系列显卡)使用OVERLAY模式（OVERLAY模式下的缩放和颜色转换由显卡支持），可以大

/// 大减小cpu利用率并提高画面质量（相对于软件缩放和颜色转换）。缺点是：只能有一路播放器使用。

/// 该设置必须在PLAY之前使用，而且需要设置透明色。

///

/// 37．BOOL Hik_PlayM4_SetOverlayMode(LONG nPort,BOOL bOverlay,COLORREF colorKey)

/// </summary>

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

/// <param name="bOverlay">如果为TRUE,表示将首先尝试使用OVERLAY模式，如果不行再使用其他模式。如果为FALSE,则不进行OVERLAY模式的尝试。 </param>

/// <param name="colorKey">

/// 用户设置的透明色，透明色相当于一层透视膜，显示的画面只能穿过这种颜色，而其他的颜色将

/// 挡住显示的画面。用户应该在显示窗口中涂上这种颜色，那样才能看到显示画面。一般应该使

/// 用一种不常用的颜色作为透明色。这是一个双字节值0x00rrggbb,最高字节为0，后三个字节分别表示r,g,b的值。

/// </param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetOverlayMode(int nPort, bool bOverlay,int colorKey);

/// <summary>

/// 获得码流中原始图像的大小，根据此大小来设置显示窗口的区域，可以不用显卡做缩放工作，对于

/// 那些不支持硬件缩放的显卡来说非常有用。

///

/// 38． BOOL Hik_PlayM4_GetPictureSize(LONG nPort,LONG *pWidth,LONG *pHeight);

/// </summary>

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

/// <param name="pWidth">原始图像的宽。在PAL制CIF格式下是352。</param>

/// <param name="pHeight">原始图像的高。在PAL制CIF格式下是288。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_GetPictureSize(int nPort, out int pWidth, out int pHeight);

/// <summary>

/// 设置图像质量，当设置成高质量时画面效果好，但CPU利用率高。在支持多路播放时，可以

/// 设为低质量，以降低CPU利用率；当某路放大播放时将该路设置成高质量，以达到好的画面效果。

///

/// 39．BOOL Hik_PlayM4_SetPicQuality(LONG nPort,BOOL bHighQuality);

/// </summary>

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

/// <param name="bHighQuality">等于1时图像高质量，等于0时低质量（默认值）。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetPicQuality(int nPort, bool bHighQuality);

/// <summary>

/// 以共享方式播放声音，只管播放本路声音而不去关闭其他路的声音。注意：WIN98及其之前

/// 版本操作系统不支持创建多个声音设备。如果声卡已经被使用，那么此函数将返回FALSE。

///

/// 40．BOOL Hik_PlayM4_PlaySoundShare(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_PlaySoundShare(int nPort);

/// <summary>

/// 以共享方式关闭声音。Hik_Playm4_PlaySound和Hik_PlayM4_StopSound是以独占方

/// 式播放声音的。注意：在同一个进程中，所有通道必须使用相同的方式播放或关闭声音。

///

/// 41．BOOL Hik_PlayM4_StopSoundShare(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_StopSoundShare(int nPort);

/// <summary>

/// 获得流模式类型。

///

/// 42. LONG Hik_PlayM4_GetStreamOpenMode(LONG nPort);

/// </summary>

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

/// <returns>STREAME_REALTIME或STREAME_FILE</returns>

[DllImport("HikPlayM4.dll")]

public static extern int Hik_PlayM4_GetStreamOpenMode(int nPort);

/// <summary>

/// 检查当前播放器是否使用了OVERLAY模式

///

/// 43.LONG Hik_PlayM4_GetOverlayMode(LONG nPort);

/// </summary>

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

/// <returns>0，表示没有使用OVERLAY；1表示使用了OVERLAY表面。</returns>

[DllImport("HikPlayM4.dll")]

public static extern int Hik_PlayM4_GetOverlayMode(int nPort);

/// <summary>

/// 获得OVERLAY表面使用的透明色

///

/// 44．COLORREF Hik_PlayM4_GetColorKey(LONG nPort);

/// </summary>

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

/// <returns>颜色值</returns>

[DllImport("HikPlayM4.dll")]

public static extern Color Hik_PlayM4_GetColorKey(int nPort);

/// <summary>

/// 获得当前设置的音量