【正文】 ine MAX_RIGHT_NUM 100 define MAX_GROUP_NUM 20 define MAX_USER_NUM 200 define RIGHT_NAME_LENGTH 32 define USER_NAME_LENGTH 8 define USER_PSW_LENGTH 8 define MEMO_LENGTH 32 typedef struct { DWORD dwID。 char memo[MEMO_LENGTH]。 typedef struct { DWORD dwID。 char name[USER_NAME_LENGTH]。 DWORD dwRightNum。 char memo[MEMO_LENGTH]。 網(wǎng)絡客戶端 SDK 編程手冊 第 20 頁 共 93 頁 typedef struct { DWORD dwID。 DWORD dwRightNum。 char memo[MEMO_LENGTH]。 ?SDK 返回的用戶信息結構 typedef struct { DWORD dwRightNum。 DWORD dwGroupNum。 DWORD dwUserNum。 }USER_MANAGE_INFO。 // 秒 160 DWORD minute :6。 // 時 124 DWORD day :5。 // 月 112 DWORD year :6。 //日志結構 struct LOG_ITEM { DHTIME time。 //類型 BYTE flag。 //數(shù)據(jù) BYTE context[8]。 網(wǎng)絡客戶端 SDK 編程手冊 第 21 頁 共 93 頁 2. 日志的類型 enum dh_log_t { LOG_REBOOT = 0x0000, //system logs LOG_SHUT, LOG_CONFSAVE = 0x0100, //config logs LOG_CONFLOAD, LOG_FSERROR = 0x0200, //文件系統(tǒng)錯誤 LOG_HDD_WERR, //硬盤寫錯誤 LOG_HDD_RERR, //硬盤讀錯誤 LOG_HDD_TYPE, //設置硬盤類型 LOG_HDD_FORMAT, //格式化硬盤 LOG_ALM_IN = 0x0300, //alarm logs //record LOG_MANUAL_RECORD_START = 0x0400, LOG_MANUAL_RECORD_STOP, //user manager LOG_LOGIN = 0x0500, LOG_LOGOUT, LOG_ADD_USER, LOG_DELETE_USER, LOG_MODIFY_USER, LOG_ADD_GROUP, LOG_DELETE_GROUP, LOG_MODIFY_GROUP, //clear LOG_CLEAR = 0x0600, //record operation LOG_DOWNLOAD, //錄像下載 LOG_PLAYBACK, //錄像回放 LOG_TYPE_NR = 8, }。 ?查詢硬盤信息的返回數(shù)據(jù)結構 typedef struct{ DWORD dwDiskNum。 //各硬盤信息 }DH_HARDDISK_STATE,*LPDH_HARDDISK_STATE。 //編碼類型， 0PCM WORD nChannels。 //采樣深度 DWORD nSamplesPerSec。 系統(tǒng)配置信息結構 目前提供了配置控件的方式配置設備 4 接口定義 SDK 初始化 1. CLIENT_API DWORD CALL_METHOD CLIENT_GetLastError(void)。 2. CLIENT_API BOOL CLIENT_Init(fDisConnect cbDisConnect, DWORD dwUser)。 設 置為 0 時禁 止 回調(diào) dwUser 用戶數(shù)據(jù) 網(wǎng)絡客戶端 SDK 編程手冊 第 23 頁 共 93 頁 ? 回調(diào)函數(shù)參數(shù)說 明 ： lLoginID CLIENT_Login的返回值 pchDVRIP 設備 IP nDVRPort 端口 dwUser 用戶數(shù)據(jù)，就是上面輸入的用戶數(shù)據(jù) ? 返回值：成功返回 TRUE，不成功返回 FALSE ? 相關函數(shù)： CLIENT_Cleanup ? 典型應用：在應用程序初始化時調(diào)用 3. CLIENT_API void CLIENT_Cleanup()。 ? 參數(shù)：無 ? 返回值：無 ? 相關函數(shù)： CLIENT_Init ? 典型應用： 在應用程序關 閉時調(diào)用 4. CLIENT_API void CLIENT_SetConnectTime(int nWaitTime, int nTryTimes)。 ? 參數(shù) 說明 ： nWaitTime 連接等待時間，毫秒級 nTryTimes 連接次數(shù)，暫時為無效值 ? 返回值：無 ? 相關函數(shù)： CLIENT_Login ? 典型應用：一般在應用程序初始化時調(diào)用 網(wǎng)絡客戶端 SDK 編程手冊 第 24 頁 共 93 頁 5. CLIENT_API DWORD CLIENT_GetSDKVersion()。 6. CLIENT_API void CLIENT_SetDVRMessCallBack(fMessCallBack cbMessage, DWORD dwUser)。 ? 參數(shù) 說明 ： cbMessage 消息回調(diào)函數(shù)，可以回調(diào)設備的狀態(tài) , 如報警狀態(tài)可 以通過此回調(diào)獲取 。 － SHELTER_ALARM：填充 數(shù)據(jù)為 16個字節(jié)，每個字節(jié)表示一個視頻通道的遮擋報警狀態(tài)， 1為有報警， 0為無報警 － DISK_FULL_ALARM， 填充 數(shù)據(jù)為 1個 DWORD值 ， 1表示 硬盤滿 ， 0表示 硬盤未滿 。 － SOUND_DETECT_ALARM： 填充 數(shù)據(jù)為 16個字節(jié)，每個字節(jié)表示一個視頻 網(wǎng)絡客戶端 SDK 編程手冊 第 25 頁 共 93 頁 通道的 音頻 報警狀態(tài)， 1為有報警， 0為無報警 如果調(diào)用的偵聽接口為 CLENT_StartListenEx， 則 lCommand的可能值是 ： － DH_ALARM_ALARM_EX：填充數(shù)據(jù)為 16個字節(jié)，每個字節(jié)表示一個報警通道的報警狀態(tài)， 1為有報警， 0為無報警。 － DH_VIDEOLOST_ALARM_EX： 填充數(shù)據(jù)為 16個字節(jié)，每個字節(jié)表示一個視頻通道的視頻丟失報警狀態(tài)， 1為有報警， 0為無報警。 － DH_SOUND_DETECT_ALARM_EX： 填充數(shù)據(jù)為 16個字節(jié)，每個字節(jié)表示一個視頻通道的音頻檢測報警狀態(tài)， 1為有報警， 0為無報警。 － DH_DISKERROR_ALARM_EX： 填充數(shù)據(jù)為 32個字節(jié)，每個字節(jié)表示一個硬盤的故障報警狀態(tài)， 1為有報警， 0為無報警。 7. CLIENT_API BOOL CLIENT_StartListen(LONG lLoginID)。 ? 參數(shù) 說明 ： lLoginID CLIENT_Login的返回值 ? 返回值：成功返回 TRUE，失敗返回 FALSE ? 相關函數(shù)： CLIENT_SetDVRMessCallBack， CLIENT_StopListen 典型應用：在設備連接后調(diào)用本函數(shù)打開偵聽 網(wǎng)絡客戶端 SDK 編程手冊 第 26 頁 共 93 頁 8. CLIENT_API BOOL CLIENT_StartListenEx(LONG lLoginID) ? 函數(shù)說明：開始對某個設備偵聽消息 ,用來設置是否需要對設備消息回調(diào)，得到的消息從 CLIENT_SetDVRMessCallBack的設置值回調(diào)出來。 ? 參數(shù) 說明 ： lLoginID CLIENT_Login的返回值 ? 返回值：成功返回 TRUE，失敗返回 FALSE ? 相關函數(shù)： CLIENT_SetDVRMessCallBack， CLIENT_StopListen ? 典型應用：在設備連接后調(diào)用本函數(shù)打開偵聽 9. CLIENT_API BOOL CLIENT_StopListen(LONG lLoginID)。 10. CLIENT_API void CLIENT_RigisterDrawFun(fDrawCallBack cbDraw, DWORD dwUser)。 ? 參數(shù) 說明 ： cbDraw 畫圖回調(diào) ， 當設置為 0 時表示禁止回調(diào) dwUser 用戶數(shù)據(jù) ? 回調(diào)函數(shù)說明 : LoginID 網(wǎng)絡客戶端 SDK 編程手冊 第 27 頁 共 93 頁 CLIENT_Login的返回值，標識設備 。 hDC 是對整個顯示畫面區(qū)域的畫板指針 ,根據(jù)用戶的需要可以對任何位置疊加顯示 。 ? 返回值：無 ? 相關函數(shù) : 無 ? 典型應用：本接口最好在應用程序初始化時就調(diào)用 ,具體的處理在回調(diào)函數(shù)中根據(jù) 當前 畫面 ID(可以是監(jiān)視 ,多畫面預覽 ,回放 )疊加不同的信息 。 ? 函數(shù)說明：注冊用戶到設備 ，當設備端把用戶設置為復用（設備默認的用戶不能設置為復用），該帳號可以多次向設備注冊 ? 參數(shù) 說明 ： pchDVRIP 設備 IP wDVRPort 設備端口 pchUserName 用戶名 pchPassword 用戶密碼 lpDeviceInfo 設備信息 ,屬于輸出參數(shù) error (當函數(shù)返回成功時 ,該參數(shù)的值無意義 )， 返回登錄錯誤碼： 網(wǎng)絡客戶端 SDK 編程手冊 第 28 頁 共 93 頁 ，系統(tǒng)忙 ? 返回值： 失敗返回 0， 成功返回設備 ID， 登錄成功之后對設備的操作都可以通過此 值 (設備句柄 )對應到相應的設備 ? 相關函數(shù)： CLIENT_Logout ? 典型應用：在初始化后就可以調(diào)用本接口注冊到指定的設備，成功后將返回設備句柄，給相關的函數(shù)調(diào)用 12. CLIENT_API LONG CLIENT_LoginEx(char *pchDVRIP, WORD wDVRPort, char *pchUserName, char *pchPassword, int nSpecCap, void* pCapParam, LPNET_DEVICEINFO lpDeviceInfo, int *error = 0) ? 函數(shù)說明： 注冊用戶到設備的擴 展接口 ， 支持一個用戶 指定設備支持的能力 ? 參數(shù) 說明 ： 增加擴展參數(shù) nSpecCap 設備支持的能力，值為 1 表示同一用戶名可以多次登錄 , 其他 暫時 不支持 pCapParam 對 nSpecCap 的補充參數(shù) , 目前為 0 ? 返回值 : 失敗返回 0，成功返回設備 ID，登錄成功之后對設備的操作都可以通過此值 (設備句柄 )對應到相應的設備 ? 相關函數(shù) : CLIENT_Logout ? 典型應用：一個用戶同時 多次登錄同一臺設備 13. CLIENT_API BOOL CLIENT_Logout(LONG lLoginI