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)證功能，登錄成功后，返回的用戶TD作

為其他功能操作的唯一標(biāo)識(shí)。

1.1SDK初始化

1）初始化SDK

接口:NETDVRJnit

函數(shù)：BOOLNET_DVR」nit參

數(shù)：無(wú)

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。

說(shuō)明：調(diào)用設(shè)備網(wǎng)絡(luò)SDK其他函數(shù)的前提。

2）釋放SDK資源

接口：NET_DVR_Cleanup

函數(shù)：BOOLNETDVRCleanup參

數(shù)：無(wú)

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。

說(shuō)明：在結(jié)束之前最后調(diào)用。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

1.2NVR用戶的認(rèn)證/登錄

1)激活設(shè)備

接口：NET_DVR_ActivateDevice

函數(shù)：BOOLNET_DVR_ActivateDevice(char*sDVRIP,WORD

wDVRPort,LPNETDVRACTIVATECFG1pActivateCfg)

參數(shù)：

[in]sDVR!P設(shè)備IP地址

[in]wDVRPort設(shè)備端口

[in]IpActivateCfg激活參數(shù)，包括激活使用的初始密碼

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)

用NET_DVR_GetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣

由。

說(shuō)明：出廠設(shè)備需要先激活，然后再使用激活使用的初始密瑪?shù)?/p>

錄設(shè)備。

2)IPServer或者DDNS域名解析，獵取動(dòng)態(tài)IP地址和端口號(hào)

接口：NET_DVR_GetDVRIPByResolveSvr_EX

函數(shù)：BOOLNET_DVRGetDVRIPByResolveSvr_EX(char*

sServerIP,WORDwServerPort,BYTE*sDVRName,WORD

wDVRNameLen,BYTE*sDVRSerialNumber,WORDwDVRSerialLen,

char*sGetTP,DWORD*dwPort)

參數(shù)：

[in]sServerIP解析效勞器的IP地址

[in]wServerPort解析效勞器的端口號(hào)，IPServer解析效

勞器端口號(hào)為7071,HiDDNS效勞器的端口號(hào)為80

[in]sDVRName設(shè)備名稱(chēng)

[in]wDVRNameLen設(shè)備名稱(chēng)的長(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è)備名稱(chēng)和設(shè)備序列號(hào)不能同時(shí)為空。通過(guò)

設(shè)備域名或者序列號(hào)解析出設(shè)備當(dāng)前IP地址和端口，然后調(diào)用

NET_DVR_Login_V40登錄設(shè)備。支持的解析效勞器有TPServer和

hiDDNSo

3)用戶注冊(cè)設(shè)備

接口：NET_DVR_Login_V40

函數(shù)：LONGNET_DVR_Login_V40(LPNET_DVR_USER_LOGIN_INFO

pLoginlnfo,LPNETDVRDEVICEINFOV40IpDevicelnfo)

參數(shù):

[in]pLoginInfo登錄參數(shù)，包括設(shè)備池址、登錄用戶、密碼等

[out]IpDevicelnfo設(shè)備信息(同步登錄即pLoginlnfo中

bUseAsynLogin為0時(shí)有效

返回侑：異步登錄的狀態(tài)、用戶ID和設(shè)備信息通過(guò)

NET_DVR_USER_LOGIN_INFO結(jié)構(gòu)體中設(shè)置的回調(diào)函數(shù)

(fLoginResultCallBack)返回。對(duì)于同步登錄，接口返回T表示

登錄失敗，其他值表示返回的用戶ID值。用戶1D具有唯一性，

后續(xù)對(duì)設(shè)備的操作都需要通過(guò)此ID實(shí)現(xiàn)。接口返回失敗請(qǐng)調(diào)用

NET_DVR_GetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明:pLoginlnfo中bUseAsynLogin為0時(shí)登錄為同步模式,

接口返回成功即表示登錄成功；pLoginlnfo中bUseAsynLogin為

1時(shí)登錄為異步模式，登錄是否成功在輸入?yún)?shù)設(shè)置的回調(diào)函數(shù)

中返回。設(shè)備同時(shí)最多允許128個(gè)用戶注冊(cè)。SDK支持2048個(gè)

注冊(cè)，返回UserID的取值范圍為0~2047。

4)用戶注銷(xiāo)

接口：NET_DVR_Logout

函數(shù)：BOOLNET_DVR_Logout(LONGlUserlD)

參數(shù)：

[in]WserID用戶ID號(hào)，NET_DVR_Login_V40的返回值返

回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGctLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：建議使用此接口實(shí)現(xiàn)注銷(xiāo)功能。

2視頻監(jiān)控掃瞄

1)啟動(dòng)預(yù)覽

接口：NET_DVR_Re&1P1ay_V40

函數(shù)：LONGNET_DVR_RealPlay_V40(LONGlUserlD,

LPNET_DVR_PREVIEWINFOIpPreviewlnfo,

REALDATACALLBACKfRealDataCallBack_V30,void*pUser)

參數(shù)：

[in]lUserlDNET_DVR_Login_V40的返回值

[in]IpPreviewInfo預(yù)覽參數(shù)，包括通道號(hào)、碼流類(lèi)型、取流協(xié)議

[in]fRealDataCalIBackV30碼流數(shù)據(jù)回調(diào)函數(shù)

[in]pUser用戶數(shù)據(jù)

返回值：-1表示失敗，其他值作為NETJ)V'R_StopRealPlay等函數(shù)

的句柄參數(shù)。接口返回失敗請(qǐng)調(diào)用

NET_DVR_GetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。說(shuō)

明：該接口預(yù)覽參數(shù)構(gòu)造中可以設(shè)置當(dāng)前預(yù)覽操作是否堵塞

(通過(guò)bBlocked參數(shù)設(shè)置)，假設(shè)設(shè)為不堵塞，表示發(fā)起與設(shè)備的

連接就認(rèn)為連接成功，假設(shè)發(fā)生碼流接收失敗、播放失敗等狀況

以預(yù)覽特別的方式通知上層。在循環(huán)播放的時(shí)候可以減短停頓的時(shí)

間，與NET_DVR_RealPlay處理全都。假設(shè)設(shè)為堵塞，表示直到播放

操作完成才返回成功與否。

該接口中的回調(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)本身的接口。

Linux64位系統(tǒng)不支持軟解碼功能，因此需要將窗口句柄傳NULL,

設(shè)置回調(diào)函數(shù)，只取流不解碼顯示。

客戶端特別離線時(shí)，設(shè)備端對(duì)取流連接的保持時(shí)間為10秒。

2)停頓預(yù)覽

接口：NET_DVR_StopRealPlay

函數(shù)：LONGNETDVRStopRealPlay(LONGIRealHandle)

參數(shù)：[in]IRealHandle預(yù)覽句柄，NET_DVR_RealPlay_V40的返

回值

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：

3)獵取預(yù)覽時(shí)用來(lái)解碼和顯示的播放庫(kù)句柄

接口：NET_DVR_GetRealPlayerIndex

函數(shù)：intNETDVRGetRealPlayerIndex(LONGIRealHandle)

參數(shù)：[in]IRealHandle預(yù)覽句柄,NET_DVR_RealPlay_V40的返

回值

返回值：-1表示失敗，其他值表示播放句柄。接口返回失敗請(qǐng)調(diào)用

NET_DVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。說(shuō)

明：用戶可以通過(guò)返回的句柄自行實(shí)現(xiàn)播放庫(kù)SDK供給的其他

功能，詳見(jiàn)本公司供給的軟解碼庫(kù)函數(shù)說(shuō)明《播放器SDK編程指南》。

3IPC錄像

3.1IPC信息操作

1)獵取IPC信息列表

接口：NET_DV1<GetSadpInfoList

函數(shù)：BOOLNET_DVR_GetSadpInfoList(LONGlUserlD,

LPNET_DVR_SADPINFO_LISTIpSadpInfoList)

參數(shù)：[in]lUserIDNET_DVR_Login_V40的返回值

[out]IpSadpInfoListIPC信息列表構(gòu)造

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGctLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：

2)修改IPC信息

接口：NET_DVR_UpdateSadpInfo

函數(shù)：BOOLNETDVRUpdateSadpInfo(LONGWserlD,

LPNET_DVR_SADP_VERIFY1pSadpVerify,

LPNETDVRSADPINFOIpSadpInfo)

參數(shù)：[inHUserlDNET_DVR_Login_V40的返回值

[in]IpSadpVerify校驗(yàn)信息

[in]IpSadpInfo修改的IPC信息列表構(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ù)：BOOLNET_DVR_SetAudioMode(DWORDdwMode)

參數(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ù):BOOLNET_DVROpenSound(LONGIRealHandle)

參數(shù)：[in]IRealHandleNET_DVR_RealPlay_V40的返回值

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NET_DVR_GetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：假設(shè)當(dāng)前是共享模式播放，調(diào)用該接口將返回失敗。以獨(dú)占

方式只能翻開(kāi)一路通道播放，即依次翻開(kāi)多個(gè)通道時(shí)僅翻開(kāi)最終一

路。

3)獨(dú)占聲卡模式下關(guān)閉聲音

接口：NET_DVR_CloseSound

函數(shù)：BOOLNET_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ù)：BOOLNET_DVR_OpenSoundShare(LONGIRealHandle)

參數(shù)：[in]IRealHandleNET_DVR_Rea1P1ay_V40的返回值

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：

5)共享聲卡模式下關(guān)閉聲音

接口：NET_DVR_CloseSoundShare

函數(shù)：BOOLNET_DVR_CloseSoundShare(LONGIRealHandle)

參數(shù):[in]IRealHandleNETDVR_RealPlay_V40的返回值

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NET_DVR_GetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：

6)調(diào)整播放音量

接口：NETDVRVolume

函數(shù):BOOLNET_DVR_Volume(LONGIRealHandle,WORDwVolume)

參數(shù)：[in]lRealHandleNETDVRRealPlayV40的返回值

[in]wVolume音量，取值范圍[0,Oxffff]

返回值：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_SetRea1DataCa11Back

函數(shù)：BOOLNET_DVR_SetRealDataCalIBack(LONGIRealHandle,

fRealDataCalIBackcbRealDataCalIBack,DWORDdwUser)

參數(shù)：

[in]lRealHandle預(yù)覽句柄，NET_DVRRealPlay.V40的返回值

[in]cbRealDataCal1Back碼流數(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é)。

cbRealDataCallBackBl調(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ù)：BOOLNETDVRSetStandardDataCalIBack（LONGIRealHandle,

fStdDataCalIBackcbStdDataCalIBack,DWORDdwUser）

參數(shù)：

[in]lRealHandle預(yù)覽句柄，NET_DVR_RealPlay_V40的返回值

[in]cbStdDataCalIBack標(biāo)準(zhǔn)碼流回調(diào)函數(shù)

[in]dwUser用戶數(shù)據(jù)

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。說(shuō)

明：此函數(shù)包括開(kāi)頭和停頓用戶處理SDK捕獲的數(shù)據(jù)，當(dāng)回調(diào)函

數(shù)cbStdDataCaHBack設(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頭）。

cbStdDataCallBack回調(diào)函數(shù)中不能執(zhí)行可能會(huì)占用時(shí)間較長(zhǎng)的

接口或操作，不建議調(diào)用該SDK(HCNetSDK.dll)本身的接口。

此函數(shù)僅支持對(duì)于支持RTSP協(xié)議取流的設(shè)備的標(biāo)準(zhǔn)碼流回調(diào)。

3)捕獲數(shù)據(jù)并保存到指定的文件中

接口：NET_DVR_SaveRealData

函數(shù)：BOOLNETDVRSaveRealData(LONGIRealHandle,

char*sFileName)

參數(shù)：

[in]lRealllandleNET_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ī)章為“在接口傳入的文件名根底

上增加數(shù)字標(biāo)識(shí)(例如：*」.mp4、*_2.mp4)”。

4)停頓數(shù)據(jù)捕獲

接口：NET_DVR_StopSaveRealData

函數(shù):BOOLNETDVRStopSaveRealData(LONGIRealHandle)

參數(shù)：[in]IRealHandleNET_DVR_RealPlay_V40的返回值

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明:

3.4預(yù)覽抓圖

1)設(shè)置抓圖模式

接口：NET_DVR_SetCapturePictureMode

函數(shù)：BOOL

NETDVRSetCapturePictureMode(DWORD

dwCaptureMode)

參數(shù)：[in]dwCaptureMode抓圖模式：

enumtagPDC_PARAM_KEY{

BMP_MODE=0,//BMP模式

JPEGJIODE=1//JPEG模式

}CAPTUREJIODE

返回值：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ù)捕獲并保存成圖片

接口：NETDVRCapturePicture

函數(shù)：BOOLNET_DVR_CapturePicture(LONG1RealHandle,

char*sPicFileName)

參數(shù)：

[in]lKealHandleNET_DVR_RealElay_V40的返回值

LinJsPicFileName保存圖象的文件路徑。路徑長(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模

式。假設(shè)抓圖模式為BMP模式，抓取的是BMP圖片，保存路徑后綴

應(yīng)為.bmp；假設(shè)抓圖模式為JPEG模式，抓取的是JPEG圖片，保存

路徑后綴應(yīng)為.jpg。

假設(shè)設(shè)備的當(dāng)前區(qū)分率為2CIF,播放庫(kù)做了相關(guān)處理，抓取的圖

像為4CIF。

調(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ù)：BOOLNET_DVR_CaptureJPEGPicture（LONGWserlD,

LONGIChannel,LPNET_DVR_JPEGPARAIpJpegPara,

char*sPicFileName）

參數(shù)：[in]lUserlDNET_DVR_Login_V40的返回值

[in]IChannel通道號(hào)

LinJIpJpegParaJPEG圖像參數(shù)

[inlsPicFileName保存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ù)保存成文

件。抓圖功能和抓圖區(qū)分率需要設(shè)備支持，IPC設(shè)備一般只支持當(dāng)前

視頻區(qū)分率的抓取。

4)單幀數(shù)據(jù)捕獲并保存成JPEG存放在指定的內(nèi)存空間中

接口：NETDVRCaptureJPEGPicture_NEW

函數(shù)：BOOLNET_DVR_CaptureJPEGPicture_NEW(LONGWserlD,

LONGIChannel,LPNET_DVR_JPEGPARAIpJpegPara,

char*sJpegPicBuffer,DWORDdwPicSize,

LPDWORDIpSizeReturned)

參數(shù)：[in]lUserIDNETDVRLogin_V40的返回值

[in]IChannel通道號(hào)

[in]IpJpegParaJPEG圖像參數(shù)

[in]sJpegPicBuffer保存JPEG數(shù)據(jù)的緩沖區(qū)

[in]dwPicSize輸入緩沖區(qū)大小

[out]IpSizeReturned返回圖片數(shù)據(jù)的大小

返回值：TRUE表示成功，F(xiàn)ALSE表示失敗。接口返回失敗請(qǐng)調(diào)用

NETDVRGetLastError獵取錯(cuò)誤碼，通、過(guò)錯(cuò)誤碼推斷出錯(cuò)緣由。

說(shuō)明：該接口用于設(shè)備的單幀數(shù)據(jù)捕獲：SDK發(fā)送命令給設(shè)備，設(shè)

備抓圖之后返回客戶端，然后SDK將接收到的JPEG圖片數(shù)據(jù)保存在

sJpegPicBuffer緩沖區(qū)里。抓圖功能和抓圖區(qū)分率需要設(shè)備支持，

IPC設(shè)備一般只支持當(dāng)前視頻區(qū)分率的抓取。

4云臺(tái)掌握操作

對(duì)IPC的操作，包括左、右、上、下移動(dòng)等。

1）云臺(tái)掌握操作（需先啟動(dòng)圖像預(yù)覽）

接口：NET_DVR_PTZControl

函數(shù)：BOOLNET_DVR_PTZControl（LONGIRealHandle,

DWORDdwPTZCommand,DWORDdwStop）

參數(shù)：

[in]IRealHandleNET_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_GetLastEr「or獵取錯(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è)置的解碼器種類(lèi)和解

碼器地址向云臺(tái)發(fā)送掌握碼。假設(shè)目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)

備的不匹配，需要重配置設(shè)備的解碼器。

假設(shè)云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口掌握。

云臺(tái)默認(rèn)以最大速度動(dòng)作。

2）云臺(tái)掌握操作（不用啟動(dòng)圖像預(yù)覽）

接口：NET_DVR_PTZControl_Other

函數(shù)：BOOLNET_DVR_PTZControl_Other（LONGlUserlD,

LONGIChannel,DWORDdwPTZCommand,DWORDdwStop）

參數(shù)：

[in]IUserlDNET_DVR_Login_V40的返回值

[in]IChannel通道號(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_GetLastEr「or獵取錯(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è)置的解碼器種類(lèi)和解

碼器地址向云臺(tái)發(fā)送掌握碼。假設(shè)目前設(shè)備上設(shè)置的解碼器與云臺(tái)設(shè)

備的不匹配，需要重配置設(shè)備的解碼器。

假設(shè)云臺(tái)設(shè)備所需的解碼器設(shè)備不支持，則無(wú)法用該接口掌握。

云臺(tái)默認(rèn)以最大速