设备网络SDK开发使用手册 |
启动监听,接收设备主动上传的报警等信息。
BOOL NET_DVR_StartListen( char *sLocalIP, WORD wLocalPort );
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 | 监听失败。 |
要使PC能够收到设备主动发过来的报警等信息,必须将设备的网络配置中的“远程管理主机地址”或者“远程报警主机地址”设置成PC机的IP地址(与接口中的sLocalIP参数一致),“远程管理主机端口号”或者“远程报警主机端口号”设置成PC机的监听端口号(与接口中的wLocalPort参数一致)。启动监听后,需要调用注册回调函数的接口(仅需按需求调用NET_DVR_SetDVRMessageCallBack_V30、NET_DVR_SetDVRMessCallBack、NET_DVR_SetDVRMessCallBack_EX、NET_DVR_SetDVRMessCallBack_NEW和NET_DVR_SetDVRMessageCallBack其中的一个)才能获取到上传的报警等信息。
NET_DVR_SetDVRMessageCallBack_V30
NET_DVR_SetDVRMessCallBack_NEW
扩展接口可见