NVR的SKD二次開(kāi)發(fā)接口文檔.doc

《NVR的SKD二次開(kāi)發(fā)接口文檔.doc》由會(huì)員分享，可在線閱讀，更多相關(guān)《NVR的SKD二次開(kāi)發(fā)接口文檔.doc（20頁(yè)珍藏版）》請(qǐng)?jiān)谘b配圖網(wǎng)上搜索。

NVR的SDK二次開(kāi)發(fā)接口文檔 采購(gòu)的海康NVR及IPC的產(chǎn)品需支持SDK版本在xxx上 能夠支持輸出RTSP協(xié)議流 以下SDK的接口是必須的 1 賬號(hào)驗(yàn)證 用戶登錄NVR：實(shí)現(xiàn)用戶的認(rèn)證功能，登錄成功后，返回的用戶ID 作為其他功能操作的唯一標(biāo)識(shí)。 1.1 SDK初始化 1) 初始化SDK 接口：NET_DVR_Init 函數(shù)： BOOL NET_DVR_Init() 參數(shù)： 無(wú) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。 說(shuō)明： 調(diào)用設(shè)備網(wǎng)絡(luò)SDK 其他函數(shù)的前提。 2) 釋放SDK 資源 接口：NET_DVR_Cleanup 函數(shù)： BOOL NET_DVR_Cleanup() 參數(shù)： 無(wú) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。 說(shuō)明： 在結(jié)束之前最后調(diào)用。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 1.2 NVR用戶的認(rèn)證/登錄 1) 激活設(shè)備 接口：NET_DVR_ActivateDevice 函數(shù)： BOOL NET_DVR_ActivateDevice(char* sDVRIP, WORD wDVRPort, LPNET_DVR_ACTIVATECFGlpActivateCfg) 參 數(shù)： [in]sDVRIP 設(shè)備IP 地址 [in]wDVRPort 設(shè)備端口 [in]lpActivateCfg 激活參數(shù)，包括激活使用的初始密碼 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō)明： 出廠設(shè)備需要先激活，然后再使用激活使用的初始密碼登錄設(shè)備。 2) IPServer 或者DDNS 域名解析，獲取動(dòng)態(tài)IP 地址和端口號(hào) 接口：NET_DVR_GetDVRIPByResolveSvr_EX 函數(shù)：BOOL NET_DVR_GetDVRIPByResolveSvr_EX (char* sServerIP, WORD wServerPort, BYTE* sDVRName, WORD wDVRNameLen, BYTE* sDVRSerialNumber, WORD wDVRSerialLen, char* sGetIP, DWORD* dwPort) 參數(shù)： [in]sServerIP 解析服務(wù)器的IP 地址 [in]wServerPort 解析服務(wù)器的端口號(hào)，IP Server 解析服務(wù)器端口號(hào)為7071，HiDDNS 服務(wù)器的端口號(hào)為80 [in]sDVRName 設(shè)備名稱 [in]wDVRNameLen 設(shè)備名稱的長(zhǎng)度 [in]sDVRSerialNumber 設(shè)備的序列號(hào) [in]wDVRSerialLen 設(shè)備序列號(hào)的長(zhǎng)度 [out]sGetIP 獲取到的設(shè)備IP 地址指針 [out]dwPort 獲取到的設(shè)備端口號(hào)指針 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 該接口中的設(shè)備名稱和設(shè)備序列號(hào)不能同時(shí)為空。通過(guò)設(shè)備域名或者序列號(hào)解析出設(shè)備當(dāng)前IP地址和端口，然后調(diào)用NET_DVR_Login_V40 登錄設(shè)備。支持的解析服務(wù)器有IPServer 和hiDDNS。 3) 用戶注冊(cè)設(shè)備 接口：NET_DVR_Login_V40 函 數(shù)： LONG NET_DVR_Login_V40(LPNET_DVR_USER_LOGIN_INFO pLoginInfo,LPNET_DVR_DEVICEINFO_V40 lpDeviceInfo) 參 數(shù)： [in]pLoginInfo 登錄參數(shù)，包括設(shè)備地址、登錄用戶、密碼等 [out]lpDeviceInfo 設(shè)備信息(同步登錄即pLoginInfo 中bUseAsynLogin 為0 時(shí)有效 返回值： 異步登錄的狀態(tài)、用戶ID 和設(shè)備信息通過(guò) NET_DVR_USER_LOGIN_INFO 結(jié)構(gòu)體中設(shè)置的回調(diào)函數(shù)(fLoginResultCallBack)返回。對(duì)于同步登錄，接口返回-1 表示登錄失敗，其他值表示返回的用戶ID 值。用戶ID 具有唯一性，后續(xù)對(duì)設(shè)備的操作都需要通過(guò)此ID 實(shí)現(xiàn)。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： pLoginInfo 中bUseAsynLogin 為0 時(shí)登錄為同步模式，接口返回成功即表示登錄成功；pLoginInfo中bUseAsynLogin 為1 時(shí)登錄為異步模式，登錄是否成功在輸入?yún)?shù)設(shè)置的回調(diào)函數(shù)中返回。設(shè)備同時(shí)最多允許128 個(gè)用戶注冊(cè)。SDK 支持2048 個(gè)注冊(cè)，返回UserID 的取值范圍為0~2047。 4) 用戶注銷 接口：NET_DVR_Logout 函 數(shù)： BOOL NET_DVR_Logout(LONG lUserID) 參 數(shù)： [in]lUserID 用戶ID 號(hào)，NET_DVR_Login_V40 的返回值 返回值：TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 建議使用此接口實(shí)現(xiàn)注銷功能。 2 視頻監(jiān)控瀏覽 1) 啟動(dòng)預(yù)覽 接口：NET_DVR_RealPlay_V40 函 數(shù)： LONG NET_DVR_RealPlay_V40(LONG lUserID, LPNET_DVR_PREVIEWINFO lpPreviewInfo, REALDATACALLBACK fRealDataCallBack_V30, void *pUser) 參 數(shù)： [in] lUserID NET_DVR_Login_V40 的返回值 [in] lpPreviewInfo 預(yù)覽參數(shù)，包括通道號(hào)、碼流類型、取流協(xié)議 [in] fRealDataCallBack_V30 碼流數(shù)據(jù)回調(diào)函數(shù) [in] pUser 用戶數(shù)據(jù) 返回值： -1 表示失敗，其他值作為NET_DVR_StopRealPlay 等函數(shù)的句柄參數(shù)。接口返回失敗請(qǐng)調(diào)用 NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： l 該接口預(yù)覽參數(shù)結(jié)構(gòu)中可以設(shè)置當(dāng)前預(yù)覽操作是否阻塞（通過(guò)bBlocked 參數(shù)設(shè)置），若設(shè)為不阻塞，表示發(fā)起與設(shè)備的連接就認(rèn)為連接成功，如果發(fā)生碼流接收失敗、播放失敗等情況 以預(yù)覽異常的方式通知上層。在循環(huán)播放的時(shí)候可以減短停頓的時(shí)間，與NET_DVR_RealPlay處理一致。若設(shè)為阻塞，表示直到播放操作完成才返回成功與否。 l 該接口中的回調(diào)函數(shù)可以置為空，這樣該函數(shù)將不回調(diào)碼流數(shù)據(jù)給用戶，不過(guò)用戶仍可以通過(guò)接口NET_DVR_SetRealDataCallBack 或NET_DVR_SetStandardDataCallBack 注冊(cè)捕獲碼流數(shù)據(jù) 的回調(diào)函數(shù)以捕獲碼流數(shù)據(jù)。 fRealDataCallBack_V30 回調(diào)函數(shù)中不能執(zhí)行可能會(huì)占用時(shí)間較長(zhǎng)的接口或操作，不建議調(diào)用該SDK（HCNetSDK.dll）本身的接口。 l Linux 64 位系統(tǒng)不支持軟解碼功能，因此需要將窗口句柄傳NULL，設(shè)置回調(diào)函數(shù)，只取流不解碼顯示。 l 客戶端異常離線時(shí)，設(shè)備端對(duì)取流連接的保持時(shí)間為10 秒。 2) 停止預(yù)覽 接口：NET_DVR_StopRealPlay 函 數(shù)： LONG NET_DVR_StopRealPlay (LONG lRealHandle) 參 數(shù)： [in]lRealHandle 預(yù)覽句柄，NET_DVR_RealPlay_V40 的返回值 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 3) 獲取預(yù)覽時(shí)用來(lái)解碼和顯示的播放庫(kù)句柄 接口：NET_DVR_GetRealPlayerIndex 函 數(shù)： int NET_DVR_GetRealPlayerIndex(LONG lRealHandle) 參 數(shù)： [in]lRealHandle 預(yù)覽句柄，NET_DVR_RealPlay_V40 的返回值 返回值： -1 表示失敗，其他值表示播放句柄。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 用戶可以通過(guò)返回的句柄自行實(shí)現(xiàn)播放庫(kù)SDK 提供的其他功能，詳見(jiàn)本公司提供的軟解碼庫(kù)函數(shù)說(shuō)明《播放器SDK 編程指南》。 3 IPC錄像 3.1 IPC信息操作 1) 獲取IPC信息列表 接口：NET_DVR_GetSadpInfoList 函 數(shù)： BOOL NET_DVR_GetSadpInfoList(LONG lUserID, LPNET_DVR_SADPINFO_LIST lpSadpInfoList) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [out]lpSadpInfoList IPC 信息列表結(jié)構(gòu) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 2) 修改IPC信息 接口：NET_DVR_UpdateSadpInfo 函 數(shù)： BOOL NET_DVR_UpdateSadpInfo(LONG lUserID, LPNET_DVR_SADP_VERIFY lpSadpVerify, LPNET_DVR_SADPINFO lpSadpInfo) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [in]lpSadpVerify 校驗(yàn)信息 [in]lpSadpInfo 修改的IPC 信息列表結(jié)構(gòu) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 3.2 聲音控制功能 1) 設(shè)置聲音播放模式 接口：NET_DVR_SetAudioMode 函 數(shù)： BOOL NET_DVR_SetAudioMode(DWORD dwMode) 參 數(shù)： [in]dwMode 聲音播放模式：1- 獨(dú)占聲卡，單路音頻模式；2- 共享聲卡，多路音頻模式 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 不調(diào)用該接口設(shè)置聲音播放模式，默認(rèn)為獨(dú)占播放。 2) 獨(dú)占聲卡模式下開(kāi)啟聲音 接口：NET_DVR_OpenSound 函 數(shù)： BOOL NET_DVR_OpenSound(LONG lRealHandle) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 如果當(dāng)前是共享模式播放，調(diào)用該接口將返回失敗。以獨(dú)占方式只能打開(kāi)一路通道播放，即依次打開(kāi)多個(gè)通道時(shí)僅打開(kāi)最后一路。 3) 獨(dú)占聲卡模式下關(guān)閉聲音 接口：NET_DVR_CloseSound 函 數(shù)： BOOL NET_DVR_CloseSound() 參 數(shù)： 無(wú) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 4) 共享聲卡模式下開(kāi)啟聲音 接口：NET_DVR_OpenSoundShare 函 數(shù)： BOOL NET_DVR_OpenSoundShare(LONG lRealHandle) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 5) 共享聲卡模式下關(guān)閉聲音 接口：NET_DVR_CloseSoundShare 函 數(shù)： BOOL NET_DVR_CloseSoundShare (LONG lRealHandle) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 6) 調(diào)節(jié)播放音量 接口：NET_DVR_Volume 函 數(shù)： BOOL NET_DVR_Volume(LONG lRealHandle,WORD wVolume) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 [in]wVolume 音量，取值范圍[0,0xffff] 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 3.3 實(shí)時(shí)預(yù)覽數(shù)據(jù)捕獲 1) 注冊(cè)回調(diào)函數(shù)，捕獲實(shí)時(shí)碼流數(shù)據(jù) 接口：NET_DVR_SetRealDataCallBack 函 數(shù)： BOOL NET_DVR_SetRealDataCallBack(LONG lRealHandle, fRealDataCallBack cbRealDataCallBack,DWORD dwUser) 參 數(shù)： [in]lRealHandle 預(yù)覽句柄，NET_DVR_RealPlay_V40 的返回值 [in]cbRealDataCallBack 碼流數(shù)據(jù)回調(diào)函數(shù) [in]dwUser 用戶數(shù)據(jù) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 此函數(shù)包括開(kāi)始和停止用戶處理SDK 捕獲的數(shù)據(jù)，當(dāng)回調(diào)函數(shù)cbRealDataCallBack 設(shè)為非NULL值時(shí)，表示回調(diào)和處理數(shù)據(jù)；當(dāng)設(shè)為NULL 時(shí)表示停止回調(diào)和處理數(shù)據(jù)。回調(diào)的第一個(gè)包是 40 個(gè)字節(jié)的文件頭，供后續(xù)解碼使用，之后回調(diào)的是壓縮的碼流?；卣{(diào)數(shù)據(jù)最大為256K 字節(jié)。 l cbRealDataCallBack回調(diào)函數(shù)中不能執(zhí)行可能會(huì)占用時(shí)間較長(zhǎng)的接口或操作，不建議調(diào)用該SDK（HCNetSDK.dll）本身的接口。 2) 注冊(cè)回調(diào)函數(shù)，捕獲實(shí)時(shí)碼流數(shù)據(jù)（標(biāo)準(zhǔn)碼流） 接口：NET_DVR_SetStandardDataCallBack 函 數(shù)： BOOL NET_DVR_SetStandardDataCallBack(LONG lRealHandle, fStdDataCallBack cbStdDataCallBack,DWORD dwUser) 參 數(shù)： [in]lRealHandle 預(yù)覽句柄，NET_DVR_RealPlay_V40 的返回值 [in]cbStdDataCallBack 標(biāo)準(zhǔn)碼流回調(diào)函數(shù) [in]dwUser 用戶數(shù)據(jù) 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 此函數(shù)包括開(kāi)始和停止用戶處理SDK 捕獲的數(shù)據(jù)，當(dāng)回調(diào)函數(shù)cbStdDataCallBack 設(shè)為非NULL值時(shí)，表示回調(diào)和處理數(shù)據(jù)；當(dāng)設(shè)為NULL 時(shí)表示停止回調(diào)和處理數(shù)據(jù)?；卣{(diào)的第一個(gè)包是40 個(gè)字節(jié)的文件頭，供后續(xù)解碼使用，之后回調(diào)的是標(biāo)準(zhǔn)碼流（含12 字節(jié)的RTP 頭）。 l cbStdDataCallBack 回調(diào)函數(shù)中不能執(zhí)行可能會(huì)占用時(shí)間較長(zhǎng)的接口或操作，不建議調(diào)用該SDK（HCNetSDK.dll）本身的接口。 l 此函數(shù)僅支持對(duì)于支持RTSP 協(xié)議取流的設(shè)備的標(biāo)準(zhǔn)碼流回調(diào)。 3) 捕獲數(shù)據(jù)并保存到指定的文件中 接口：NET_DVR_SaveRealData 函 數(shù)： BOOL NET_DVR_SaveRealData(LONG lRealHandle, char *sFileName) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 [in]sFileName 文件路徑指針 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： V5.0.3.2 或以后版本，通過(guò)該接口保存錄像，文件最大限制為1024MB，大于1024M 時(shí)，SDK 自動(dòng)新建文件進(jìn)行保存，文件開(kāi)始將40 字節(jié)頭自動(dòng)寫(xiě)入，文件名命名規(guī)則為“在接口傳入的文件 名基礎(chǔ)上增加數(shù)字標(biāo)識(shí)(例如：*_1.mp4、*_2.mp4)”。 4) 停止數(shù)據(jù)捕獲 接口：NET_DVR_StopSaveRealData 函 數(shù)： BOOL NET_DVR_StopSaveRealData(LONG lRealHandle ) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 3.4 預(yù)覽抓圖 1) 設(shè)置抓圖模式 接口：NET_DVR_SetCapturePictureMode 函 數(shù)： BOOL NET_DVR_SetCapturePictureMode( DWORD dwCaptureMode) 參 數(shù)： [in]dwCaptureMode 抓圖模式： enum tagPDC_PARAM_KEY{ BMP_MODE = 0, // BMP 模式 JPEG_MODE = 1 // JPEG 模式 }CAPTURE_MODE 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 調(diào)用該接口設(shè)置抓圖模式后，NET_DVR_CapturePicture 可抓取相應(yīng)的圖片。 2) 預(yù)覽時(shí)，單幀數(shù)據(jù)捕獲并保存成圖片 接口：NET_DVR_CapturePicture 函 數(shù)： BOOL NET_DVR_CapturePicture(LONG lRealHandle, char *sPicFileName) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 [in]sPicFileName 保存圖象的文件路徑。路徑長(zhǎng)度和操作系統(tǒng)有關(guān)，sdk 不做限制，windows 默認(rèn)路徑長(zhǎng)度小于等于256 字節(jié)（包括文件名在內(nèi)）。 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 在調(diào)用該接口之前可以調(diào)用NET_DVR_SetCapturePictureMode 設(shè)置抓圖模式，默認(rèn)為BMP 模 式。如果抓圖模式為BMP 模式，抓取的是BMP 圖片，保存路徑后綴應(yīng)為.bmp；如果抓圖模式為JPEG 模式，抓取的是JPEG 圖片，保存路徑后綴應(yīng)為.jpg。 l 若設(shè)備的當(dāng)前分辨率為2CIF，播放庫(kù)做了相關(guān)處理，抓取的圖像為4CIF。 l 調(diào)用NET_DVR_CapturePicture 進(jìn)行抓圖，實(shí)際是播放庫(kù)解碼抓圖，要求在調(diào)用NET_DVR_RealPlay_V40 等接口時(shí)傳入非空的播放句柄（播放庫(kù)解碼顯示），否則時(shí)接口會(huì)返回失?。ㄕ{(diào)用次序錯(cuò)誤）。 3) 單幀數(shù)據(jù)捕獲并保存成JPEG 圖片 接口：NET_DVR_CaptureJPEGPicture 函 數(shù)： BOOL NET_DVR_CaptureJPEGPicture(LONG lUserID, LONG lChannel, LPNET_DVR_JPEGPARA lpJpegPara, char *sPicFileName) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [in]lChannel 通道號(hào) [in]lpJpegPara JPEG 圖像參數(shù) [in]sPicFileName 保存JPEG 圖的文件路徑 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 該接口用于設(shè)備的單幀數(shù)據(jù)捕獲：SDK 發(fā)送命令給設(shè)備，設(shè)備抓圖之后返回客戶端，然后SDK將接收到的JPEG 圖片數(shù)據(jù)保存成文件。抓圖功能和抓圖分辨率需要設(shè)備支持，IPC 設(shè)備一般只支持當(dāng)前視頻分辨率的抓取。 4) 單幀數(shù)據(jù)捕獲并保存成JPEG 存放在指定的內(nèi)存空間中 接口：NET_DVR_CaptureJPEGPicture_NEW 函 數(shù)： BOOL NET_DVR_CaptureJPEGPicture_NEW(LONG lUserID, LONG lChannel, LPNET_DVR_JPEGPARA lpJpegPara, char *sJpegPicBuffer, DWORD dwPicSize, LPDWORD lpSizeReturned) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [in]lChannel 通道號(hào) [in]lpJpegPara JPEG 圖像參數(shù) [in]sJpegPicBuffer 保存JPEG 數(shù)據(jù)的緩沖區(qū) [in]dwPicSize 輸入緩沖區(qū)大小 [out]lpSizeReturned 返回圖片數(shù)據(jù)的大小 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通、過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 該接口用于設(shè)備的單幀數(shù)據(jù)捕獲：SDK 發(fā)送命令給設(shè)備，設(shè)備抓圖之后返回客戶端，然后SDK將接收到的JPEG圖片數(shù)據(jù)保存在sJpegPicBuffer 緩沖區(qū)里。抓圖功能和抓圖分辨率需要設(shè)備支持， IPC 設(shè)備一般只支持當(dāng)前視頻分辨率的抓取。 4 云臺(tái)控制操作 對(duì)IPC的操作，包括左、右、上、下移動(dòng)等。 1) 云臺(tái)控制操作（需先啟動(dòng)圖像預(yù)覽） 接口：NET_DVR_PTZControl 函 數(shù)： BOOL NET_DVR_PTZControl(LONG lRealHandle, DWORD dwPTZCommand,DWORD dwStop) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 [in]dwPTZCommand 云臺(tái)控制命令 [in]dwStop 云臺(tái)停止動(dòng)作或開(kāi)始動(dòng)作：0- 開(kāi)始，1- 停止 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 對(duì)云臺(tái)實(shí)施的每一個(gè)動(dòng)作都需要調(diào)用該接口兩次，分別是開(kāi)始和停止控制，由接口中的最后一個(gè)參數(shù)（dwStop）決定。在調(diào)用此接口之前需要先開(kāi)啟預(yù)覽。與設(shè)備之間的云臺(tái)各項(xiàng)操作的命令都對(duì)應(yīng)于設(shè)備與云臺(tái)之間的控制碼，設(shè)備會(huì)根據(jù)目前設(shè)置的解碼器種類和解碼器地址向云臺(tái)發(fā)送控制碼。如果目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)備的不匹配，需要重新配置設(shè)備的解碼器。 如果云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口控制。 云臺(tái)默認(rèn)以最大速度動(dòng)作。 2) 云臺(tái)控制操作（不用啟動(dòng)圖像預(yù)覽） 接口：NET_DVR_PTZControl_Other 函 數(shù)： BOOL NET_DVR_PTZControl_Other(LONG lUserID, LONG lChannel, DWORD dwPTZCommand,DWORD dwStop) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [in]lChannel 通道號(hào) [in]dwPTZCommand 云臺(tái)控制命令 [in]dwStop 云臺(tái)停止動(dòng)作或開(kāi)始動(dòng)作：0- 開(kāi)始；1- 停止 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 對(duì)云臺(tái)實(shí)施的每一個(gè)動(dòng)作都需要調(diào)用該接口兩次，分別是開(kāi)始和停止控制，由接口中的最后一個(gè)參數(shù)（dwStop）決定。在調(diào)用此接口之前需要先注冊(cè)設(shè)備。與設(shè)備之間的云臺(tái)各項(xiàng)操作的命令都對(duì)應(yīng)于設(shè)備與云臺(tái)之間的控制碼，設(shè)備會(huì)根據(jù)目前設(shè)置的解碼器種類和解碼器地址向云臺(tái)發(fā)送控制碼。如果目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)備的不匹配，需要重新配置設(shè)備的解碼器。 如果云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口控制。 云臺(tái)默認(rèn)以最大速度動(dòng)作。 3) 帶速度的云臺(tái)控制操作（需先啟動(dòng)圖像預(yù)覽） 接口：NET_DVR_PTZControlWithSpeed 函 數(shù)： BOOL NET_DVR_PTZControlWithSpeed(LONG lRealHandle, DWORD dwPTZCommand, DWORD dwStop, DWORD dwSpeed) 參 數(shù)： [in]lRealHandle NET_DVR_RealPlay_V40 的返回值 [in] dwPTZCommand 云臺(tái)控制命令 [in]dwStop 云臺(tái)停止動(dòng)作或開(kāi)始動(dòng)作：0- 開(kāi)始；1- 停止 [in]dwSpeed 云臺(tái)控制的速度，用戶按不同解碼器的速度控制值設(shè)置。取值范圍[1,7] 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 對(duì)云臺(tái)實(shí)施的每一個(gè)動(dòng)作都需要調(diào)用該接口兩次，分別是開(kāi)始和停止控制，由接口中的最后一個(gè)參數(shù)（dwStop）決定。在調(diào)用此接口之前需要先開(kāi)啟預(yù)覽。與設(shè)備之間的云臺(tái)各項(xiàng)操作的命令都對(duì)應(yīng)于設(shè)備與云臺(tái)之間的控制碼，設(shè)備會(huì)根據(jù)目前設(shè)置的解碼器種類和解碼器地址向云臺(tái)發(fā)送控制碼。如果目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)備的不匹配，需要重新配置設(shè)備的解碼器。 如果云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口控制。 4) 帶速度的云臺(tái)控制操作（不用啟動(dòng)圖像預(yù)覽） 接口：NET_DVR_PTZControlWithSpeed_Other 函 數(shù)： BOOL NET_DVR_PTZControlWithSpeed(LONG lUserID, LONG lChannel, DWORD dwPTZCommand, DWORD dwStop, DWORD dwSpeed) 參 數(shù)： [in]lUserID NET_DVR_Login_V40 的返回值 [in]lChannel 通道號(hào) [in]dwPTZCommand 云臺(tái)控制命令，詳見(jiàn)表 5.11 [in]dwStop 云臺(tái)停止動(dòng)作或開(kāi)始動(dòng)作：0- 開(kāi)始；1- 停止 [in]dwSpeed 云臺(tái)控制的速度，用戶按不同解碼器的速度控制值設(shè)置。取值范圍[1,7] 返回值： TRUE 表示成功，F(xiàn)ALSE 表示失敗。接口返回失敗請(qǐng)調(diào)用NET_DVR_GetLastError 獲取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼判斷出錯(cuò)原因。 說(shuō) 明： 對(duì)云臺(tái)實(shí)施的每一個(gè)動(dòng)作都需要調(diào)用該接口兩次，分別是開(kāi)始和停止控制，由接口中的最后一個(gè)參數(shù)（dwStop）決定。在調(diào)用此接口之前不需要先開(kāi)啟預(yù)覽，登錄設(shè)備后即可實(shí)現(xiàn)控制。與設(shè)備之間的云臺(tái)各項(xiàng)操作的命令都對(duì)應(yīng)于設(shè)備與云臺(tái)之間的控制碼，設(shè)備會(huì)根據(jù)目前設(shè)置的解碼器種類和解碼器地址向云臺(tái)發(fā)送控制碼。如果目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)備的不匹配， 需要重新配置設(shè)備的解碼器。如果云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口控制。