【正文】 19. CLIENT_API BOOL CLIENT_ClientSetVideoEffect(LONG lPlayHandle, unsigned char nBrightness, 。? 函數(shù)說(shuō)明：停止實(shí)時(shí)監(jiān)視或多畫(huà)面預(yù)覽? 參數(shù)說(shuō)明：lRealHandle CLIENT_RealPlayEx的返回值? 返回值：成功返回 TRUE，失敗返回 FALSE? 相關(guān)函數(shù)：CLIENT_RealPlayEx? 典型應(yīng)用：關(guān)閉實(shí)時(shí)監(jiān)視或者多畫(huà)面預(yù)覽 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 31 頁(yè) 共 94 頁(yè)18. CLIENT_API BOOL CLIENT_ClientGetVideoEffect(LONG lPlayHandle, unsigned char *nBrightness, unsigned char *nContrast, unsigned char *nHue, unsigned char *nSaturation)。 ? 函數(shù)說(shuō)明：停止實(shí)時(shí)監(jiān)視? 參數(shù)說(shuō)明：lRealHandle CLIENT_RealPlay的返回值? 返回值：成功返回 TRUE，失敗返回 FALSE? 相關(guān)函數(shù)：CLIENT_RealPlay? 典型應(yīng)用：關(guān)閉失實(shí)監(jiān)視 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 30 頁(yè) 共 94 頁(yè)16. CLIENT_API LONG CALL_METHOD CLIENT_RealPlayEx(LONG lLoginID, int nChannelID, HWND hWnd, RealPlayType rType)? 函數(shù)說(shuō)明：?jiǎn)?dòng)實(shí)時(shí)監(jiān)視或多畫(huà)面預(yù)覽，當(dāng)打開(kāi)多畫(huà)面預(yù)覽時(shí)不能打開(kāi)語(yǔ)音對(duì)講? 參數(shù)說(shuō)明：lLoginID CLIENT_Login的返回值nChannelID 實(shí)時(shí)監(jiān)視通道號(hào)，如果 rType 為 RType_Multiplay 該參數(shù)保留。 ? 函數(shù)說(shuō)明：?jiǎn)?dòng)實(shí)時(shí)監(jiān)視? 參數(shù)說(shuō)明：lLoginID CLIENT_Login的返回值nChannelID 實(shí)時(shí)監(jiān)視通道號(hào)(通道號(hào)從 0 開(kāi)始)hWnd 窗口句柄，值為 0 對(duì)數(shù)據(jù)不解碼、不顯示圖像? 返回值：失敗返回 0，成功返回實(shí)時(shí)監(jiān)視 ID(實(shí)時(shí)監(jiān)視句柄 )，將作為相關(guān)函數(shù)的參數(shù)? 相關(guān)函數(shù)：CLIENT_StopRealPlay、CLIENT_SaveRealData、CLIENT_StopSaveRealData、 CLIENT_ClientSetVideoEffect、CLIENT_ClientGetVideoEffect、CLIENT_OpenSound、CLIENT_CloseSound 、CLIENT_SetVolume、CLIENT_SetRealDataCallBack、CLIENT_SetRealDataCallBackEx 、CLIENT_CapturePicture、CLIENT_StartTalk、CLIENT_StopTalk? 典型應(yīng)用：根據(jù)登錄時(shí)獲取到的設(shè)備信息,調(diào)用本接口,就可以打開(kāi)任何有效的一路實(shí)時(shí)監(jiān)視,顯示到指定的 hWnd 窗口,正常返回的監(jiān)視 ID,用于以下對(duì)本監(jiān)視通道的控制和操作。? 函數(shù)說(shuō)明：注銷設(shè)備用戶? 參數(shù)說(shuō)明：lLoginID CLIENT_Login的返回值? 返回值：成功返回 TRUE，失敗返回 FALSE? 相關(guān)函數(shù)： CLIENT_Login? 典型應(yīng)用：當(dāng)需要設(shè)備主動(dòng)斷開(kāi)時(shí)調(diào)用。 設(shè)備注冊(cè)11. CLIENT_API LONG CLIENT_Login(char *pchDVRIP, WORD wDVRPort, char *pchUserName, char *pchPassword, LPNET_DEVICEINFO lpDeviceInfo, int *error = 0)。dwUser 用戶數(shù)據(jù)，就是上面輸入的用戶數(shù)據(jù)。lPlayHandle CLIENT_RealPlay的返回值，標(biāo)識(shí)通道。 ? 函數(shù)說(shuō)明：用戶自定義畫(huà)圖, 在打開(kāi)圖像之前調(diào)用此函數(shù),否則無(wú)效,必須在所有窗口未顯示之前調(diào)用, 可以用來(lái)對(duì)畫(huà)面進(jìn)行字符疊加。 ? 函數(shù)說(shuō)明：停止對(duì)某個(gè)設(shè)備偵聽(tīng)消息? 參數(shù)說(shuō)明：lLoginID CLIENT_Login返回值? 返回值：成功返回 TRUE，失敗返回 FALSE? 相關(guān)函數(shù)：CLIENT_StartListen , CLENT_StartListenEx? 典型應(yīng)用：參見(jiàn) demo 程序 字符疊加typedef void (CALLBACK *fDrawCallBack)(LONG lLoginID, LONG lPlayHandle, HDC hDC, DWORD dwUser)。本函數(shù)是 CLIENT_StartListen的增強(qiáng)版本：支持的報(bào)警種類更多更全，且每一種報(bào)警都細(xì)分為單獨(dú)回調(diào)。 ? 函數(shù)說(shuō)明：開(kāi)始對(duì)某個(gè)設(shè)備偵聽(tīng)消息,用來(lái)設(shè)置是否需要對(duì)設(shè)備消息回調(diào)，得到的消息從 CLIENT_SetDVRMessCallBack的設(shè)置值回調(diào)出來(lái)。dwBufLen pBuf的長(zhǎng)度pchDVRIP 設(shè)備 IPnDVRPort 端口dwUser 回調(diào)的用戶數(shù)據(jù)，就是上面輸入的用戶數(shù)據(jù)? 返回值：TRUE 回調(diào)函數(shù)執(zhí)行正確，F(xiàn)ALSE 執(zhí)行錯(cuò)誤? 相關(guān)函數(shù)：CLIENT_Sta rtListen、CLIENT_StopListen? 典型應(yīng)用：一般在應(yīng)用程序初始化時(shí)調(diào)用設(shè)置回調(diào),在回調(diào)函數(shù)中根據(jù)不同的設(shè)備 ID 和命令值做出不同的處理。－DH_DISKFULL_ALARM_EX：填充數(shù)據(jù)為1個(gè)字節(jié)，1為有硬盤滿報(bào)警，0為無(wú)報(bào)警。－DH_SHELTER_ALARM_EX：填充數(shù)據(jù)為16個(gè)字節(jié)，每個(gè)字節(jié)表示一個(gè)視頻通道的遮擋（黑屏）報(bào)警狀態(tài)，1為有報(bào)警，0為無(wú)報(bào)警。－DH_MOTION_ALARM_EX：填充數(shù)據(jù)為16個(gè)字節(jié)，每個(gè)字節(jié)表示一個(gè)視頻通道的動(dòng)態(tài)檢測(cè)報(bào)警狀態(tài)，1為有報(bào)警，0為無(wú)報(bào)警。－ DISK_ERROR_ALARM：填充數(shù)據(jù)為 1個(gè)DWORD值，按位表示最多 32個(gè)硬 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 25 頁(yè) 共 94 頁(yè)盤的故障報(bào)警，每位為1表示有報(bào)警，為0表示無(wú)報(bào)警。 當(dāng)設(shè)置為 0 時(shí)表示禁止回調(diào)dwUser 用戶數(shù)據(jù)?回調(diào)函數(shù)參數(shù)說(shuō)明:lCommand 回調(diào)類型lLoginID CLIENT_Login的返回值pBuf 接收?qǐng)?bào)警數(shù)據(jù)的緩存，根據(jù)調(diào)用的偵聽(tīng)接口和 lCommand值不同，填充的數(shù)據(jù)不同如果調(diào)用的偵聽(tīng)接口為CLIENT_StartListen，則lCommand的可能值是：－OMM_ALARM：填充數(shù)據(jù)為一個(gè)NET_CLIENT_STATE結(jié)構(gòu)體。? 函數(shù)說(shuō)明：設(shè)置設(shè)備消息回調(diào)函數(shù), 用來(lái)得到設(shè)備當(dāng)前狀態(tài)信息,與調(diào)用順序無(wú)關(guān)，SDK 默認(rèn)不回調(diào)，此回調(diào)函數(shù)必須在調(diào)用打開(kāi)偵聽(tīng)CLIENT_StartListen或 CLENT_StartListenEx才有效,同時(shí)需要說(shuō)明的是針對(duì)目前定義的報(bào)警狀態(tài),是每秒回調(diào)設(shè)備當(dāng)前的狀態(tài)值。 ? 函數(shù)說(shuō)明：得到 SDK 的版本號(hào)? 參數(shù)：無(wú)? 返回值：版本號(hào)? 典型應(yīng)用：一般在應(yīng)用程序初始化時(shí)調(diào)用 狀態(tài)偵聽(tīng)typedef BOOL (CALLBACK *fMessCallBack)(LONG lCommand, LONG lLoginID, char *pBuf, DWORD dwBufLen, char *pchDVRIP, LONG nDVRPort, DWORD dwUser)。? 函數(shù)說(shuō)明：設(shè)置與設(shè)備的連接等待時(shí)間? 調(diào)用順序無(wú)關(guān)，SDK 默認(rèn)值為 3000ms,對(duì)外網(wǎng)一般需要增加到 5000ms,此值不影響設(shè)備連接速度, 只有當(dāng)網(wǎng)絡(luò)狀態(tài)不好時(shí)延長(zhǎng)等待時(shí)間,可以提高連接成功幾率。? 函數(shù)說(shuō)明：清空 SDK, 釋放占用的資源，在所有的 SDK 函數(shù)之后調(diào)用。? 函數(shù)說(shuō)明：初始化 SDK, 在所有的 SDK 函數(shù)之前調(diào)用? 參數(shù)說(shuō)明：cbDisConnect斷線回調(diào)函數(shù)，回調(diào)出當(dāng)前網(wǎng)絡(luò)已經(jīng)斷開(kāi)的設(shè)備, 對(duì)主動(dòng)斷開(kāi)的設(shè)備不回調(diào)。? 函數(shù)說(shuō)明：返回函數(shù)執(zhí)行失敗代碼，當(dāng)調(diào)用下面的接口失敗時(shí)，可以用該函數(shù)獲取失敗的代碼，具體錯(cuò)誤代碼參見(jiàn) 錯(cuò)誤類型代號(hào)說(shuō)明? 參數(shù)說(shuō)明：? 返回值：返回? 相關(guān)函數(shù)：? 典型應(yīng)用：參加 demotypedef void (CALLBACK *fDisConnect)(LONG lLoginID, char *pchDVRIP, LONG nDVRPort, DWORD dwUser)。 //采樣率} DH_AUDIO_FORMAT, *LPDH_AUDIO_FORMAT。 //聲道數(shù)WORD wBitsPerSample。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 22 頁(yè) 共 94 頁(yè)?音頻數(shù)據(jù)的格式結(jié)構(gòu)Typedef struct{BYTE byFormatTag。 //硬盤個(gè)數(shù)NET_DEV_DISKSTATE stDisks[DH_MAX_DISKNUM]。3. 數(shù)據(jù)組織向客戶端傳遞所有日志信息，長(zhǎng)度為 N*日志結(jié)構(gòu)長(zhǎng)度，N 為日志的條數(shù)。 //內(nèi)容}。 //標(biāo)記, 0x00 正常，0x01 擴(kuò)展，0x02 數(shù)據(jù)BYTE data。 //日期接口文檔 數(shù)字視頻錄像機(jī)網(wǎng)絡(luò)服務(wù)編程手冊(cè) 公開(kāi)WORD type。 // 年 20222063}DHTIME,*pDHTIME。 // 日 131DWORD month :4。 // 分 160DWORD hour :5。?日志信息1. 日志的結(jié)構(gòu)形式//時(shí)間結(jié)構(gòu)typedef struct _DHTIME{DWORD second :6。USER_INFO userList[MAX_USER_NUM]。USER_GROUP_INFO groupList[MAX_GROUP_NUM]。OPR_RIGHT rightList[MAX_RIGHT_NUM]。}USER_GROUP_INFO。DWORD rights[MAX_RIGHT_NUM]。char name[USER_NAME_LENGTH]。}USER_INFO。DWORD rights[MAX_RIGHT_NUM]。char passWord[USER_PSW_LENGTH]。DWORD dwGroupID。}OPR_RIGHT。char name[RIGHT_NAME_LENGTH]。 //端口狀態(tài)}ALARM_CONTROL。?報(bào)警 IO 控制 (報(bào)警輸出和報(bào)警輸入使能 )typedef struct {unsigned short index。 //校驗(yàn)位unsigned char reserve。 //數(shù)據(jù)位unsigned char stopbits。 //協(xié)議名unsigned int baudbase。 //起始簇號(hào)} NET_RECORDFILE_INFO, *LPNET_RECORDFILE_INFO。 //結(jié)束時(shí)間 unsigned int driveno。 //文件長(zhǎng)度 NET_TIME starttime。 //通道號(hào) char filename[128]。 //本地顯示狀態(tài) 0正常,1不正常}NET_DEV_WORKSTATE,*LPNET_DEV_WORKSTATE。 //報(bào)警端口的狀態(tài) 0無(wú)報(bào)警,1 有報(bào)警BYTE byAlarmOutStatic[MAX_ALARMOUT]。 //設(shè)備暫時(shí)不支持NET_DEV_CHANNELSTATE stChanStatic[MAX_CHANNUM]。typedef struct{DWORD dwDeviceStatic。 //硬盤的剩余空間DWORD dwStatus。typedef struct {DWORD dwVolume。 //客戶端連接的個(gè)數(shù), 暫時(shí)無(wú)效DWORD dwClientIP[MAX_LINK]。 //暫時(shí)無(wú)效DWORD dwBitRate。 //連接的信號(hào)狀態(tài),0正常,1 信號(hào)丟失BYTE byHardwareStatic。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 18 頁(yè) 共 94 頁(yè)?以下為查詢的設(shè)備工作狀態(tài)的相關(guān)結(jié)構(gòu)typedef struct {BYTE byRecordStatic。 //size:channelcount unsigned char *videolost。 //size:channelcount unsigned char *alarm