程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> C語言 >> 關於C語言 >> C# 視頻監控系列(2):客戶端——封裝API(1)

C# 視頻監控系列(2):客戶端——封裝API(1)

編輯:關於C語言

本章主要是在C#封裝的海康DVR客戶端SDK 的代碼上修改的,並參考《Hikvision 板卡網絡開發包編程手冊V4.7.pdf》補上更完 整的注釋,並且參照VC++源碼做了小部分修改。

參考

1.C#封裝的海康DVR客戶端SDK

注意

本系列文章限於學習交流,注重過程,由於涉及公司,所以不提供源代碼下載,非常抱歉!!但是請大家放心,核心、實現以 及其他能夠貼出來的代碼我都會貼出來,並且爭取盡所能的回答評論裡的每一個問題,感謝大家關注,歡迎交流 :)

正文

本章主 要是貼封裝好的API調用代碼,所以直接就貼代碼了。

代碼說明:

1.C#調用VC++寫好的DLL在這裡就不介紹了,重點和難點在於 參數數據類型對應,下一章將有所總結。

2.注釋比較詳盡,注釋裡summary節點裡有函數的VC++原型。

using System;
using System.Runtime.InteropServices;

namespace HikClIEnt
{
    #region struct

    /// <summary>
    /// 客戶端的參數結構
    /// 說明:如果將m_bUserCheck置為FALSE,則把用戶名和密碼作為空指針發送到服務器。雖然用戶名和密
    /// 碼的內容不能超過50字節,但是用戶名和密碼緩沖區長度必須大於等於50,因為內部操作的時候直接從
    /// 用戶名或密碼緩沖區拷貝50字節到發送緩沖區裡。
    /// </summary>
    public struct CLIENT_VIDEOINFO
    {
        /// <summary>
        /// 對應服務端的的通道號
        /// </summary>
        public byte m_bRemoteChannel;
        /// <summary>
        /// 網絡連接方式
        /// </summary>
        public byte m_bSendMode;
        /// <summary>
        /// 圖像格式,0為服務端主通道的圖像 ;1為服務端子通道的圖像
        /// </summary>
        public byte m_nImgFormat;
        /// <summary>
        /// 服務端的IP地址
        /// </summary>
        public string m_sIPAddress;
        /// <summary>
        /// 用戶名
        /// </summary>
        public string m_sUserName;
        /// <summary>
        /// 密碼
        /// </summary>
        public string m_sUserPassWord;
        /// <summary>
        /// 是否需要發送用戶名和密碼
        /// </summary>
        public bool m_bUserCheck;
        /// <summary>
        /// 顯示區域
        /// </summary>
        public System.IntPtr m_hShowVideo;
    }

    #endregion

    #region enum

    /// <summary>
    /// 網絡連接方式
    /// </summary>
    public enum SEND_MODE
    {
        /// <summary>
        /// UDP方式
        /// </summary>
        UDPMODE = 0,
        /// <summary>
        /// TCP方式
        /// </summary>
        TCPMODE,
        /// <summary>
        /// 多播方式
        /// </summary>
        MULTIMODE,
        /// <summary>
        /// 電話線方式
        /// </summary>
        DIALING,
        /// <summary>
        /// 音頻流暢模式
        /// </summary>
        AUDIODETACH
    };

    /// <summary>
    /// 顯示模式
    /// </summary>
    public enum DISP_MODE
    {
        /// <summary>
        /// 可以同時顯示多個窗口,但對顯卡有一定要求
        /// </summary>
        NORMALMODE = 0,
        /// <summary>
        /// 只能同時顯示一個窗口,但是對顯卡沒有什麼要求
        /// </summary>
        OVERLAYMODE
    };

    #endregion

    #region delegate

    /// <summary>
    /// 讀實時數據回調。用於讀取數據流。如果ReadDataCallBack為null,表示不需要讀取數據流
    ///
    /// Void(CALLBACK*ReadDataCallBack)(DWORD nChannel,UCHAR *pPacketBuffer,DWord nPacketSize));
    /// </summary>
    /// <param name="nChannel">表示通道號</param>
    /// <param name="pPacketBuffer">數據緩存指針</param>
    /// <param name="nPacketSize">數據個數</param>
    public delegate void ReadDataCallBack(ulong nChannel, [MarshalAs(UnmanagedType.LPArray)] byte[] pPacketBuffer, ulong nPacketSize);

    /// <summary>
    /// 捕圖回調
    ///
    /// void (CALLBACK* CapPicFun)(long StockHandle, char * pBuf, long nSize, long nWidth, long nHeight, long nStamp, long nType, long nReceaved)
    /// </summary>
    /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
    /// <param name="pBuf">返回圖像數據</param>
    /// <param name="nSize">返回圖像數據大小</param>
    /// <param name="nWidth">畫面寬,單位像素</param>
    /// <param name="nHeight">畫面高</param>
    /// <param name="nStamp">時標信息,單位毫秒</param>
    /// <param name="nType">數據類型, T_RGB32,T_UYVY詳見宏定義說明。</param>
    /// <param name="nReceaved">保留</param>
    public delegate void CapPicFun(int StockHandle, IntPtr pBuf, int nSize, int nWidth, int nHeight, int nStamp, int nType, int nReceaved);

    /// <summary>
    /// 畫
    /// </summary>
    public delegate void DrawFun(int StockHandle, System.Drawing.Graphics hDc, int nUser);


    #endregion

    /// <summary>
    /// hikclient.dll   HikClIEnt
    /// </summary>
    public class PcHikClIEnt
    {

        public static readonly uint WM_USER = 0x0400;

        #region 客戶端函數

        /// <summary>
        /// 對客戶端初始化
        ///     注:在調用所有其他客戶端函數之前調用。
        ///
        /// 1.BOOL  __stdcall MP4_ClIEntStartup(UINT nMessage,HWND hWnd);
        /// </summary>
        /// <param name="nMessage">表示對應接收程序的消息。</param>
        /// <param name="hWnd">表示應用程序窗口句柄。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntStartup(uint nMessage, IntPtr hWnd);

        /// <summary>
        /// 結束調用客戶端函數。
        ///     注:調用MP4_ClIEntCleanup()後不能再調用其他客戶端函數。
        ///
        /// 2.BOOL  __stdcall MP4_ClIEntCleanup();
        /// </summary>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntCleanup();

        /// <summary>
        /// 啟動客戶端
        ///     注 :MP4_ClientStart返回成功,並不表示已經成功連接服務端。您需要通過MP4_ClIEntGetState函數
        ///     去獲得網絡連接的狀態
        ///
        /// 3.LONG __stdcall MP4_ClientStart(PCLIENT_VIDEOINFO pClIEntinfo, Void(CALLBACK*ReadDataCallBack)(DWORD nChannel,UCHAR *pPacketBuffer,DWord nPacketSize));
        /// </summary>
        /// <param name="pClIEntinfo"></param>
        /// <param name="rdcb">用來讀取數據流。如果ReadDataCallBack為NULL,表示不需要讀取數據流。 </param>
        /// <returns>返回-1表示失敗,其他值表示成功。作為後續操作的參數。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern int MP4_ClientStart(ref CLIENT_VIDEOINFO pClIEntinfo, ReadDataCallBack rdcb);

        /// <summary>
        /// 停止客戶端。
        ///
        /// 4.BOOL  __stdcall MP4_ClIEntStop(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntStop(long StockHandle);

        /// <summary>
        /// 獲取客戶端狀態
        ///     -1  :   無效
        ///     1   :   連接
        ///     2   :   開始接收圖像
        ///     3   :   異常退出
        ///     4   :   接收完畢,退出
        ///     5   :   無法聯系服務器
        ///     6   :   服務器拒絕訪問
        ///
        /// 5.LONG  __stdcall MP4_ClIEntGetState(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">成功返回的值</param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern int MP4_ClIEntGetState(long StockHandle);

        /// <summary>
        /// 開始客戶端的數據捕獲(回調方式,使用MP4_ClIEntStart中的ReadDataCallBack函數)。
        ///
        /// 6.BOOL __stdcall MP4_ClIEntStartCapture(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntStartCapture(long StockHandle);

        /// <summary>
        /// 開始客戶端的數據捕獲(直接寫文件方式)。
        ///
        /// 7.BOOL  __stdcall MP4_ClIEntStartCaptureFile(LONG StockHandle, LPTSTR FileName);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="FileName">文件名。 </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntStartCaptureFile(int StockHandle, string FileName);

         /// <summary>
        /// 停止客戶端的數據捕獲。
        ///     對MP4_ClientStartCapture和MP4_ClIEntStartCaptureFile都有效。
        ///
        /// 8.BOOL __stdcall MP4_ClIEntStopCapture(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntStopCapture(int StockHandle);

        /// <summary>
        /// 獲取服務端的通道數。
        ///
        /// 9.Word  __stdcall MP4_ClIEntGetServerChanNum(LPCTSTR m_sIPAddress);
        /// </summary>
        /// <param name="m_sIPAddress">服務端的IP地址。</param>
        /// <returns>返回0表示失敗,其他值表示通道數。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern ushort MP4_ClIEntGetServerChanNum(string m_sIPAddress);

        /// <summary>
        /// 給服務器發送字符串
        ///
        /// 10.BOOL  __stdcall MP4_ClIEntCommandtoServer(LPCTSTR m_lAddrIP, char *m_sCommand,Word m_wLen)
        /// </summary>
        /// <param name="m_lAddrIP">服務器IP地址</param>
        /// <param name="m_sCommand">消息緩沖指針</param>
        /// <param name="m_wLen">消息緩沖長度,必須小於900個字節</param>
        /// <returns>返回0表示失敗,其他值表示通道數。 </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntCommandtoServer(string m_lAddrIP, string m_sCommand, ushort m_wLen);

        /// <summary>
        /// 對服務端的nChannel通道網絡連接初始化,結束當前所有用戶對它的訪問。
        ///
        /// 11.BOOL  __stdcall MP4_ClIEntShut(LPCTSTR m_lAddrIP,char nChannel);
        /// </summary>
        /// <param name="m_lAddrIP">表示服務端的IP地址。</param>
        /// <param name="cChannel">表示服務端通道號。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。 </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntShut(string m_lAddrIP, char cChannel);

        /// <summary>
        /// 讀取服務端消息。
        ///     讀取服務端MP4_ServerStringToClIEnt函數發送過來的消息。(不超過900字節)
        ///
        /// 12.void  __stdcall MP4_ClIEntReadLastMessage(char * m_sIP ,char *m_sCommand,Word *m_wLen);
        /// </summary>
        /// <param name="m_sIP">消息來自哪個IP地址。</param>
        /// <param name="m_sCommand">消息緩沖區指針。 </param>
        /// <param name="m_wLen">消息緩沖區長度。</param>
        [DllImport("hikclIEnt.dll")]
        public static extern void MP4_ClIEntReadLastMessage(string m_sIP, out string m_sCommand, out ushort m_wLen);

        /// <summary>
        /// 設置當前播放器音量。
        ///
        /// 13.BOOL  __stdcall MP4_ClIEntAudioVolume(Word wVolume);
        /// </summary>
        /// <param name="wVolume">音量值(0-0xffff) </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudioVolume(ushort wVolume);

        /// <summary>
        /// 選定某個播放器播放聲音,其他播放器靜止。
        ///
        /// 14.BOOL  __stdcall MP4_ClIEntAudiOStart(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudiOStart(long StockHandle);

        /// <summary>
        /// 停止播放聲音
        ///
        /// 15.BOOL  __stdcall MP4_ClIEntAudiOStop();
        /// </summary>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。 </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudiOStop();

        /// <summary>
        /// 功能同MP4_ClientCommandtoServer,只是第一個參數使用了MP4_ClIEntStart成功返回的值。
        ///
        /// 16.BOOL __stdcall MP4_ClIEntCommandtoServer_Handle(LONG StockHandle,char *m_sCommand, Word m_wLen);
        /// </summary>
        /// <param name="StockHandle"></param>
        /// <param name="m_sCommand"></param>
        /// <param name="m_wLen"></param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntCommandtoServer_Handle(int StockHandle, out string m_sCommand, ushort m_wLen);

        /// <summary>
        /// 系統是否支持網絡播放器(在顯示模式設為NORMALMODE的情況下)。
        ///
        /// 17.int   __stdcall MP4_ClIEntIsSupport();
        /// </summary>
        /// <returns>返回值的低8位每位表示一個信息。每一位的定義如上所示,0表示不支持,1表示支持。
        /// 如果SUPPORT_DDRAW、SUPPORT_BLT、SUPPORT_CPU其中有一個為0,表示播放器根本無法播放;
        /// 如果SUPPORT_BLTFOUR、SUPPORT_BLTSHRINKX、SUPPORT_BLTSHRINKY、
        /// SUPPORT_BLTSTRETCHX、SUPPORT_BLTSTRETCHY其中有一個為0,表示播放器雖然能夠播放,但
        /// 是效率很低,有可能因為CPU利用率太高而無法顯示。
        /// 播放器必須在增強色(16位),或者真彩色(32位)模式下運行。如果出現SUPPORT_BLTFOURCC、
        /// SUPPORT_BLTSHRINKX、SUPPORT_BLTSHRINKY、SUPPORT_BLTSTRETCHX、
        /// SUPPORT_BLTSTRETCHY其中有一個為0,會采用軟件顯示方式,這時候必須在真彩色(32位)模式下才
        /// 能運行。
        /// </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern int MP4_ClIEntIsSupport();

        /// <summary>
        /// 增加接收緩沖區大小。
        ///     說明:WBufNum值每增加1,表示接收緩沖區增加1幀的數據量。如果以5幀/秒的幀率播放,那麼WbufNum=5,表示 增加了5幀的緩沖區。
        ///
        /// 18.BOOL  __stdcall MP4_ClIEntSetBufferNum(LONG StockHandle,Word wBufNum);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="wBufNum">增加緩沖區個數,0-50。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetBufferNum(long StockHandle, ushort wBufNum);

        /// <summary>
        /// 設置服務端的網絡端口號和客戶端的網絡端口號。同MP4_ServerSetNetPort
        ///
        /// 19.BOOL  __stdcall MP4_ClIEntSetNetPort(WORD dServerPort,Word dClIEntPort);
        /// </summary>
        /// <param name="dServerPort">服務端的起始網絡端口號。</param>
        /// <param name="dClIEntPort">客戶端的網絡端口號。</param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClientSetNetPort(ushort dServerPort, ushort dClIEntPort);

         /// <summary>
        /// 設置多播的TTL參數。
        ///
        /// 20.BOOL     __stdcall MP4_ClIEntSetTTL(unsigned char cTTLVal);
        /// </summary>
        /// <param name="cTTLVal">TTL值。1-255,默認32。 </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetTTL(char cTTLVal);

        /// <summary>
        /// 接收多少數據後才開始播放。
        ///
        /// 21.BOOL  __stdcall MP4_ClIEntSetPlayDelay(LONG StockHandle,Word DelayLen);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="DelayLen">預先接收的數據量。單位:K。范圍:0-600</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetPlayDelay(long StockHandle, ushort DelayLen);

        /// <summary>
        /// 設置連接服務端的等待時間和嘗試次數。參數說明同MP4_ServerSetWait。
        ///
        /// 22.BOOL  __stdcall MP4_ClIEntSetWait(DWORD dEachWaitTime,DWord dTrynum);
        /// </summary>
        /// <param name="dEachWaitTime"></param>
        /// <param name="dTrynum"></param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetWait(ulong dEachWaitTime, ulong dTrynum);

        /// <summary>
        /// 設置播放器的顯示模式。
        ///
        /// 23.BOOL  __stdcall MP4_ClIEntSetShowMode(DWord dShowType,COLORREF colorKey);
        /// </summary>
        /// <param name="dShowType">顯示模式。NORMALMODE或者OVERLAYMODE。</param>
        /// <param name="colorKey">用戶設置的透明色,透明色相當於一層透視膜,顯示的畫面只能穿過這種顏 色,而其他的顏色
        /// 將擋住顯示的畫面。用戶應該在顯示窗口中塗上這種顏色,那樣才能看到顯示畫面。一般應該使用一種不
        /// 常用的顏色作為透明色。這是一個雙字節值0x00rrggbb,最高字節為0,後三個字節分別表示r,g,b的值。 </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        //public static extern bool MP4_ClIEntSetShowMode(UInt32 dShowType, System.Drawing.Color colorKey);
        public static extern bool MP4_ClIEntSetShowMode(ulong dShowType, int colorKey);

        /// <summary>
        /// 設置圖象質量。
        ///     說明:設置圖像質量,當設置成高質量時畫面效果好,但CPU利用率高。在支持多路播放時,可以設為
        ///     低質量(LOWQUALITY),以降低CPU利用率;當某路放大播放時將該路設置成高質量(HIGHQUALITY),
        ///     以達到好的畫面效果。
        ///
        /// 24.BOOL  __stdcall MP4_ClIEntSetQuality(LONG StockHandle,Word wPicQuality);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="wPicQuality">圖象質量。LOWQUALITY表示低圖象質量,HIGHQUALITY表示高圖象質量。 </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetQuality(long StockHandle, ushort wPicQuality);

         /// <summary>
        /// 設置抓圖回調函數。
        ///     注意要盡快返回,如果要停止回調,可以把回調函數指針CapPicFun設為NULL。一旦設置回調函數,則
        ///     一直有效,直到程序退出。
        ///
        /// 25.BOOL __stdcall MP4_ClIEntSetCapPicCallBack(LONG StockHandle,  void (CALLBACK* CapPicFun)(long StockHandle, char * pBuf, long nSize, long nWidth, long nHeight, long nStamp, long nType, long nReceaved));
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="x"></param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetCapPicCallBack(int StockHandle, CapPicFun x);

        /// <summary>
        /// 將抓圖得到的圖像數據保存成BMP文件。
        ///     保存函數需要占用的較多cpu資源,如果不需要保存圖片,則不要調用。
        ///
        /// 26.BOOL __stdcall  MP4_ClIEntSavePicFile(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">數據類型, T_RGB32,T_UYVY詳見宏定義說明。</param>
        /// <param name="sFileName">要保存的文件名</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSavePicFile(IntPtr pBuf, int nSize, int nWidth, int nHeight, int nType, string sFileName);


        /// <summary>
        /// 設置解碼時丟棄B幀的個數。
        ///     說明: 丟棄的B幀個數越多,CPU利用率越低,動畫感越明顯。
        ///
        /// 27.BOOL  __stdcall MP4_ClIEntThrowBFrame(LONG StockHandle,DWord dNum);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。 </param>
        /// <param name="dNum">丟棄的幀個數。(0,1,2)</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。 </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntThrowBFrame(long StockHandle, ulong dNum);

        /// <summary>
        /// 獲取已經解碼的總幀數。
        ///
        /// 28. DWord  __stdcall MP4_ClIEntGetFrameNum(LONG StockHandle);
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回幀數值。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern ulong MP4_ClIEntGetFrameNum(int StockHandle);

        /// <summary>
        /// 獲取版本號。
        ///
        /// 29.DWord  __stdcall  MP4_ClIEntGetSdkVersion()
        /// </summary>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern uint MP4_ClIEntGetSdkVersion();

        /// <summary>
        /// 30.設置播放聲音的模式。
        ///     1> SINGLEAUDIO模式下只能調用 MP4_ClientAudiOStart和MP4_ClIEntAudiOStop。
        ///     2> MULTIAUDIO模式下只能調用 MP4_ClientAudiOStartShare和MP4_ClIEntAudiOStopShare。
        ///     3>兩種模式下都可以調用MP4_ClIEntAudioVolume。
        ///     4>在客戶端軟件運行過程中,用戶可以在關閉所有播放器的聲音之後,可以調用該函數修改播放模式。但
        ///     是建議用戶最好在客戶端軟件初始化的時候設置一次播放模式,之後不再修改。
        ///
        /// 30.BOOL  __stdcall MP4_ClIEntAudioMode(Word wMode)
        /// </summary>
        /// <param name="wMode">有兩個選項。默認使用SINGLEAUDIO。
        /// SINGLEAUDIO:開發包原來的模式。在一個客戶端軟件中,同時最多只有一個播放器可以播放聲音;
        /// MULTIAUDIO:新增加的模式。在一個客戶端軟件中,同時可以有多個播放器播放聲音。
        /// </param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudioMode(ushort wMode);

        /// <summary>
        /// 開始播放某一路聲音。MULTIAUDIO模式下使用。
        ///
        /// 31. BOOL  __stdcall MP4_ClIEntAudiOStartShare(LONG StockHandle)
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudiOStartShare(long StockHandle);

        /// <summary>
        /// 停止播放聲音。MULTIAUDIO模式下使用。
        ///
        /// 32. BOOL  __stdcall MP4_ClIEntAudiOStopShare(LONG StockHandle)
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntAudiOStopShare(long StockHandle);

        /// <summary>
        /// 設置多播組地址和網絡端口號。
        /// 說明:
        ///     1>目前的多播組采用了兩種方式:一是開發包內部分配,用戶不需要考慮多播組參數細節,默認采用這種
        ///     方式;另一種是調用MP4_ClIEntCastGroup設置多播組參數。
        ///     2>該函數在MP4_ClientStart或MP4_ClIEntStart_Card之後調用。
        ///     3>每個多播組會占用wPort開始的4個端口。
        ///
        /// 33.BOOL  __stdcall MP4_ClIEntCastGroup(LONG StockHandle,char *sIP,Word wPort)
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="sIP">多播組地址。</param>
        /// <param name="wPort">多播組網絡端口號。 </param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntCastGroup(long StockHandle, out string sIP, ushort wPort);

         /// <summary>
        /// 設置疊加字幕的回調函數。
        ///
        /// 34. BOOL  __stdcall  MP4_ClIEntRigisterDrawFun(LONG StockHandle, void (CALLBACK* DrawFun)(LONG StockHandle,HDC hDc,LONG nUser),LONG nUser).
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="x">DC句柄。</param>
        /// <param name="nUser">保留。設置成NULL。</param>
        /// <returns></returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntRigisterDrawFun(long StockHandle, DrawFun x, long nUser);

         /// <summary>
        /// 清除數據緩沖區。包括客戶端和服務端
        ///
        /// 35.BOOL __stdcall MP4_ClIEntCleanBuffer(LONG nPort,int nCleanType)
        /// </summary>
        /// <param name="nPort">MP4_ClIEntStart的返回值。 </param>
        /// <param name="nCleanType">
        /// 清除類型。 nCleanType為0只清除客戶端緩沖區,nCleanType為1只清除服務端緩沖區,
        /// nCleanType為2清除客戶端/服務端緩沖區。
        /// </param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntCleanBuffer(long nPort, int nCleanType);

        /// <summary>
        /// 設置視頻參數。
        ///
        /// 36.BOOL  MP4_ClIEntSetVideoPara(LONG StockHandle,DWord nRegionNum, int nBrightness, int nContrast, int nSaturation, int nHue)
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="nRegionNum">暫時不用,設置成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>返回TRUE表示成功,返回FALSE表示失敗。 </returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntSetVideoPara(long StockHandle, ulong nRegionNum, int nBrightness, int nContrast, int nSaturation, int nHue);

        /// <summary>
        /// 獲取視頻參數。
        ///
        /// 37.BOOL  MP4_ClIEntGetVideoPara(LONG StockHandle,DWord nRegionNum, int *pBrightness, int *pContrast, int *pSaturation, int *pHue)
        /// </summary>
        /// <param name="StockHandle">MP4_ClIEntStart成功返回的值。</param>
        /// <param name="nRegionNum">暫時不用,設置成0。 </param>
        /// <param name="pBrightness">亮度,默認64; 范圍0-128;</param>
        /// <param name="pContrast">對比度,默認64; 范圍0-128;</param>
        /// <param name="pSaturation">飽和度,默認64; 范圍0-128;</param>
        /// <param name="pHue">色調,默認64; 范圍0-128;</param>
        /// <returns>返回TRUE表示成功,返回FALSE表示失敗。</returns>
        [DllImport("hikclIEnt.dll")]
        public static extern bool MP4_ClIEntGetVideoPara(long StockHandle, ulong nRegionNum, out int pBrightness, out int pContrast, out int pSaturation, out int pHue);

        #endregion
    }
}

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved