NET_DVR_StartListen_V30

启动监听，接收设备主动上传的报警等信息（支持多线程）。

LONG NET_DVR_StartListen_V30(
  char           *sLocalIP,
  WORD           wLocalPort,
  MSGCallBack    DataCallback,
  void           *pUserData
);

Parameters

sLocalIP

[in] PC机本地IP地址，可以置为NULL

wLocalPort

[in] PC本地监听端口号。由用户设置，必须和设备端设置的一致

DataCallback

[in] 回调函数

pUserData

[in] 用户数据

Callback Function

typedef void(CALLBACK *MSGCallBack)(
  LONG               lCommand,
  NET_DVR_ALARMER    *pAlarmer,
  char               *pAlarmInfo,
  DWORD              dwBufLen,
  void               *pUser
);

Callback Function Parameters

lCommand

[out] 上传的消息类型，不同的报警信息对应不同的类型，通过类型区分是什么报警信息，详见“Remarks”中列表

pAlarmer

[out] 报警设备信息，包括设备序列号、IP地址等

pAlarmInfo

[out] 报警信息，通过lCommand值判断pAlarmer对应的结构体，详见“Remarks”中列表

dwBufLen

[out] 报警信息缓存大小

pUser

[out] 用户数据

Return Values

-1表示失败，其他值作为NET_DVR_StopListen_V30函数的句柄参数。接口返回失败请调用NET_DVR_GetLastError获取错误码，通过错误码判断出错原因。

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

Remarks

要使PC能够收到设备主动发过来的报警等信息，必须将设备的网络配置中的“远程管理主机地址”或者“远程报警主机地址”设置成PC机的IP地址（与接口中的sLocalIP参数一致），“远程管理主机端口号”或者“远程报警主机端口号”设置成PC机的监听端口号（与接口中的wLocalPort参数一致）。

该接口中的回调函数优先级高于其他回调函数，即设置了该接口中的回调函数，其他回调函数将接收不到报警信息。所有设备报警信息都是在同一个回调函数中返回的，通过报警设备信息（pAlarmInfo）区分是哪台设备。

该接口中回调函数的第一个参数（lCommand）和第三个参数（pAlarmInfo）是密切关联的，其关系见下表：

报警类型是COMM_ALARM_ACS时候，如设备断开连接后，回调函数返回异常状态，获取错误码为7。

See Also

NET_DVR_StopListen_V30

Reference Interface

该接口扩展源于

NET_DVR_StartListen