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

/// <summary>

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

///

/// 2、 BOOL Hik_PlayM4_RealeseDDraw();

/// </summary>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_RealeseDDraw();

/// <summary>

/// 打开播放文件

///

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

/// </summary>

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

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

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

/// <summary>

/// 关闭播放文件

///

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

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_CloseFile(int nPort);

/// <summary>

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

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

/// 输入参数：hWnd 播放视频的窗口句柄。

///

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

/// </summary>

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

/// <param name="hWnd"></param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

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

/// <summary>

/// 播放结束

///

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

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_Stop(int nPort);

/// <summary>

/// 播放暂停/恢复

///

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

/// </summary>

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

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

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

/// <summary>

/// 快速播放，每次调用将使当前播放速度加快一倍，最多调用4次；要恢复正常播放调用

/// Hik_PlayM4_Play(),从当前位置开始正常播放

///

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

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_Fast(int nPort);

/// <summary>

/// 慢速播放，每次调用将使当前播放速度慢一倍；最多调用4次；要恢复正常播放调用Hik_PlayM4_Play

///

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

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_Slow(int nPort);

/// <summary>

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

///

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

/// </summary>

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

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

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

/// <summary>

/// 获得文件播放指针的相对位置

///

/// 11、float Hik_PlayM4_GetPlayPos(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern float Hik_PlayM4_GetPlayPos(int nPort);

/// <summary>

/// 说明：设置文件结束时要发送的消息；从2.4版开始，当文件播放完时，解码线程将不会自动结束，需要

/// 用户做停止工作：应用程序在收到这个消息后要调用播放结束函数Hik_PlayM4_Stop(nPort)。

///

/// 12、BOOL Hik_PlayM4_SetFileEndMsg(LONG nPort,HWND hWnd,UINT nMsg);

/// </summary>

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

/// <param name="hWnd">消息发送的窗口。 </param>

/// <param name="nMsg">用户自定义的输入的消息；当播放到文件结束时用户从hWnd窗口过程中收到这个消息。此消息函数中的wParam参数返回nPort的值。</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetFileEndMsg(int nPort, IntPtr hWnd, uint nMsg);

/// <summary>

/// 设置音量；可以在播放之前设置，返回值是FALSE，但设置的值被保存，并作为启动声音时的初始

///

/// 13、BOOL Hik_PlayM4_SetVolume(LONG nPort,WORD nVolume);

/// </summary>

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

/// <param name="nVolume">nVolume 音量的值，范围0-0XFFFF</param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_SetVolume(int nPort, int nVolume);

/// <summary>

/// 打开声音；同一时刻只能有一路声音。如果现在已经有声音打开，则自动关闭原来已经打开的声音。

/// 注意：默认情况下声音是关闭的！

///

/// 14．BOOL Hik_PlayM4_PlaySound(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_PlaySound(int nPort);

/// <summary>

/// 关闭声音

///

/// 15．BOOL Hik_PlayM4_StopSound();

/// </summary>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_StopSound();

/// <summary>

/// 打开流接口（类似打开文件）

///

/// 16．BOOL Hik_PlayM4_OpenStream(LONG nPort,PBYTE pFileHeadBuf,DWORD nSize,DWORD nBufPoolSize);

/// </summary>

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

/// <param name="pFileHeadBuf">用户从卡上得到的文件头数据。</param>

/// <param name="nSize">文件头长度。</param>

/// <param name="nBufPoolSize">设置播放器中存放数据流的缓冲区大小。范围是SOURCE_BUF_MIN~ SOURCE_BUF_MAX。 </param>

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_OpenStream(int nPort, IntPtr pFileHeadBuf, ushort nSize, ushort nBufPoolSize);

/// <summary>

/// 输入从卡上得到的流数据；打开流之后才能输入数据。

///

/// 17．BOOL Hik_PlayM4_InputData(LONG nPort,PBYTE pBuf,DWORD nSize);

/// </summary>

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

/// <param name="pBuf">缓冲区地址</param>

/// <param name="nSize">缓冲区大小</param>

/// <returns>TURE,表示已经输入数据。FALSE 表示失败，数据没有输入。</returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_InputData(int nPort, IntPtr pBuf, ushort nSize);

/// <summary>

/// 关闭数据流

///

/// 18.BOOL Hik_PlayM4_CloseStream(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_CloseStream(int nPort);

/// <summary>

/// 测试播放器需要的一些系统功能

/// 注意：如果显卡支持上面列出的显示功能，将会大大降低CPU利用率。解码后的图像是352*288（PAL）

/// 大小，如果显卡不支持放大缩小，则建议显示窗口也使用352*288。

///

/// 19．int Hik_PlayM4_GetCaps();

/// </summary>

/// <returns>

/// 1~8位分别表示以下信息（位与是TRUE表示支持）：

/// SUPPORT_DDRAW 支持DIRECTDRAW；如果不支持，则播放器不能工作。

/// SUPPORT_BLT 显卡支持BLT操作；如果不支持，则播放器不能工作。

/// SUPPORT_BLTFOURCC 显卡BLT支持颜色转换；如果不支持，播放器会使用软件方式作RGB转换。

/// SUPPORT_BLTSHRINKX 显卡BLT支持X轴缩小；如果不支持，系统使用软件方式转换。

/// SUPPORT_BLTSHRINKY 显卡BLT支持Y轴缩小；如果不支持，系统使用软件方式转换。

/// SUPPORT_BLTSTRETCHX 显卡BLT支持X轴放大；如果不支持，系统使用软件方式转换。

/// SUPPORT_BLTSTRETCHY 显卡BLT支持Y轴放大；如果不支持，系统使用软件方式转换。

/// SUPPORT_SSE CPU支持SSE指令,Intel Pentium3以上支持SSE指令；

/// SUPPORT_MMX CPU支持MMX指令集。

///

/// </returns>

[DllImport("HikPlayM4.dll")]

public static extern int Hik_PlayM4_GetCaps();

/// <summary>

/// 得到文件总的时间长度，单位秒

///

/// 20．DWORD Hik_PlayM4_GetFileTime(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern int Hik_PlayM4_GetFileTime(int nPort);

/// <summary>

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

///

/// 21． DWORD Hik_PlayM4_GetPlayedTime(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetPlayedTime(int nPort);

/// <summary>

/// 得到已经解码的视频帧数

///

/// 22．DWORD Hik_PlayM4_GetPlayedFrames(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern ushort Hik_PlayM4_GetPlayedFrames(int nPort);

/// <summary>

/// 单帧播放。要恢复正常播放调用Hik_PlayM4_Play()

///

/// 23．BOOL Hik_PlayM4_OneByOne(LONG nPort);

/// </summary>

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

/// <returns></returns>

[DllImport("HikPlayM4.dll")]

public static extern bool Hik_PlayM4_OneByOne(int nPort);