设备网络SDK开发使用手册

NET_DVR_StartListen

启动监听,接收设备主动上传的报警等信息。

BOOL NET_DVR_StartListen(
  char    *sLocalIP,
  WORD    wLocalPort
);

Parameters

sLocalIP
[in] PC机本地IP地址,可以置为NULL
wLocalPort
[in] PC本地监听端口号。由用户设置,必须和设备端设置的一致

Return Values

TRUE表示成功,FALSE表示失败。接口返回失败请调用NET_DVR_GetLastError获取错误码,通过错误码判断出错原因。

以下是该接口可能返回的错误值

错误类型 错误值 错误信息
NET_DVR_NOERROR 0 没有错误。
NET_DVR_NOINIT 3 SDK未初始化。
NET_DVR_VERSIONNOMATCH 6 版本不匹配。SDK和设备的版本不匹配。
NET_DVR_ORDER_ERROR 12 调用次序错误。
NET_DVR_PARAMETER_ERROR 17 参数错误。SDK接口中给入的输入或输出参数为空。
NET_DVR_ALLOC_RESOURCE_ERROR 41 SDK资源分配错误。
NET_DVR_CREATESOCKET_ERROR 44 创建SOCKET出错。
NET_DVR_USERNOTEXIST 47 用户不存在。注册的用户ID已注销或不可用。
NET_DVR_BINDSOCKET_ERROR 72 绑定套接字失败。
NET_DVR_SOCKETLISTEN_ERROR 75 监听失败。

Remarks

要使PC能够收到设备主动发过来的报警等信息,必须将设备的网络配置中的“远程管理主机地址”或者“远程报警主机地址”设置成PC机的IP地址(与接口中的sLocalIP参数一致),“远程管理主机端口号”或者“远程报警主机端口号”设置成PC机的监听端口号(与接口中的wLocalPort参数一致)。启动监听后,需要调用注册回调函数的接口(仅需按需求调用NET_DVR_SetDVRMessageCallBack_V30、NET_DVR_SetDVRMessCallBack、NET_DVR_SetDVRMessCallBack_EX、NET_DVR_SetDVRMessCallBack_NEW和NET_DVR_SetDVRMessageCallBack其中的一个)才能获取到上传的报警等信息。

See Also

NET_DVR_StopListen

NET_DVR_SetDVRMessageCallBack_V30

NET_DVR_SetDVRMessCallBack

NET_DVR_SetDVRMessCallBack_EX

NET_DVR_SetDVRMessCallBack_NEW

NET_DVR_SetDVRMessageCallBack

Reference Interface

扩展接口可见

NET_DVR_StartListen_V30