设备网络SDK开发使用手册

NET_DVR_StartRemoteConfig

启动远程配置。

LONG NET_DVR_StartRemoteConfig(
  LONG                     lUserID,
  DWORD                    dwCommand,
  LPVOID                   lpInBuffer,
  DWORD                    dwInBufferLen,
  fRemoteConfigCallback    cbStateCallback,
  LPVOID                   pUserData
);

Parameters

lUserID
[in] NET_DVR_Login_V40等登录接口的返回值
dwCommand
[in] 配置命令，不同的功能对应不同的命令号(dwCommand)，lpInBuffer等参数也对应不同的内容，如下表所示：
dwCommand宏定义 宏定义值 含义 lpInBuffer cbStateCallback
NET_ITS_GET_ECT_CHAN_INFO 5082 获取出入口终端通道状态 NULL NULL
NET_DVR_GET_ITS_EXDEVSTATUS 5086 获取ITS所有外接设备信息 NET_DVR_EXTERNAL_DEVCOND NULL
NET_DVR_VEHICLE_CONTROL_LIST_START 3123 设置车辆黑白名单信息 NULL 返回状态
NET_DVR_GET_ALL_VEHICLE_CONTROL_LIST 3124 获取所有车辆黑白名单信息 NET_DVR_VEHICLE_CONTROL_COND NULL
NET_DVR_VEHICLELIST_CTRL_START 3133 设置车辆黑白名单信息(批量) NULL 返回状态
NET_DVR_GET_TRAFFIC_DATA 3141 获取交通数据 NET_DVR_TRAFFIC_DATA_QUERY_COND 返回状态、信息数据
NET_DVR_GET_TRAFFIC_FLOW 3142 获取交通流量 NET_DVR_TRAFFIC_FLOW_QUERY_COND 返回状态、信息数据
NET_DVR_PARKING_VEHICLE_SEND 3143 停车车辆信息下发 NULL 返回状态
NET_DVR_PARKING_CARD_SEND 3144 停车卡下发 NULL 返回状态
NET_DVR_GET_SENSOR_INFO 5061 传感器信息查询 NET_DVR_SENSOR_COND NULL
lpInBuffer
[in] 输入参数，具体内容跟配置命令相关
dwInBufferLen
[in] 输入缓冲的大小
cbStateCallback
[in] 状态回调函数
pUserData
[in] 用户数据

Callback Function

typedef void(CALLBACK *fRemoteConfigCallback)(
  DWORD    dwType,
  void     *lpBuffer,
  DWORD    dwBufLen,
  void     *pUserData
);

Callback Function Parameters

dwType
[out] 状态，具体定义如下：
dwCommand宏定义 dwType lpInBuffer
NET_DVR_VEHICLE_CONTROL_LIST_START typedef enum{
  NET_SDK_CALLBACK_STATUS_SUCCESS = 1000,
  //成功
  NET_SDK_CALLBACK_STATUS_PROCESSING,
  //处理中
  NET_SDK_CALLBACK_STATUS_FAILED
  //失败
}NET_SDK_CALLBACK_STATUS_NORMAL; 		NULL
NET_DVR_VEHICLELIST_CTRL_START typedef enum{
  NET_SDK_CALLBACK_TYPE_STATUS = 0,
  //回调状态值
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  //回调进度值
  NET_SDK_CALLBACK_TYPE_DATA
  //回调数据内容
}NET_SDK_CALLBACK_TYPE; 		dwType为0时，
前4个字节(DWORD)的值对应状态，详见:
NET_SDK_CALLBACK_STATUS_NORMAL
如果lpBuffer前4个字节数据值为
NET_SDK_CALLBACK_STATUS_FAILED时，
后面每4个字节表示一个错误号
NET_DVR_GET_TRAFFIC_DATA typedef enum{
  NET_SDK_CALLBACK_TYPE_STATUS = 0,
  //回调状态值
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  //回调进度值
  NET_SDK_CALLBACK_TYPE_DATA
  //回调数据内容
}NET_SDK_CALLBACK_TYPE; 		dwType为0时，lpInBuffer对应状态，详见:
NET_SDK_CALLBACK_STATUS_NORMAL
dwType为2时，lpInBuffer为查找到的信息数据，
对应结构体NET_DVR_TRAFFIC_DATA_QUERY_RESULT
NET_DVR_GET_TRAFFIC_FLOW typedef enum{
  NET_SDK_CALLBACK_TYPE_STATUS = 0,
  //回调状态值
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  //回调进度值
  NET_SDK_CALLBACK_TYPE_DATA
  //回调数据内容
}NET_SDK_CALLBACK_TYPE; 		dwType为0时，lpInBuffer对应状态，详见:
NET_SDK_CALLBACK_STATUS_NORMAL
dwType为2时，lpInBuffer为查找到的信息数据，
对应结构体NET_DVR_TRAFFIC_FLOW_QUERY_RESULT
NET_DVR_PARKING_VEHICLE_SEND typedef enum{
  NET_SDK_CALLBACK_TYPE_STATUS = 0,
  //回调状态值
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  //回调进度值
  NET_SDK_CALLBACK_TYPE_DATA
  //回调数据内容
}NET_SDK_CALLBACK_TYPE; 		dwType为0时，
前4个字节(DWORD)的值对应状态，详见:
NET_SDK_CALLBACK_STATUS_NORMAL
如果lpBuffer前4个字节数据值为
NET_SDK_CALLBACK_STATUS_FAILED时，
后面每4个字节表示一个错误号
NET_DVR_PARKING_CARD_SEND typedef enum{
  NET_SDK_CALLBACK_TYPE_STATUS = 0,
  //回调状态值
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  //回调进度值
  NET_SDK_CALLBACK_TYPE_DATA
  //回调数据内容
}NET_SDK_CALLBACK_TYPE; 		dwType为0时，
前4个字节(DWORD)的值对应状态，详见:
NET_SDK_CALLBACK_STATUS_NORMAL
如果lpBuffer前4个字节数据值为
NET_SDK_CALLBACK_STATUS_FAILED时，
后面每4个字节表示一个错误号
lpBuffer
[out] 存放数据的缓冲区指针，具体内容跟dwType相关
dwBufLen
[out] 缓冲区大小
pUserData
[out] 用户数据

Return Values

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

Remarks

调用该接口启动长连接远程配置后，还需要调用其他接口获取或者设置相关参数，如下表所示：
dwCommand宏定义 含义 后续接口调用
NET_ITS_GET_ECT_CHAN_INFO 获取出入口终端通道状态 NET_DVR_GetNextRemoteConfig
NET_DVR_GET_ITS_EXDEVSTATUS 获取ITS所有外接设备信息 NET_DVR_GetNextRemoteConfig
NET_DVR_VEHICLE_CONTROL_LIST_START 设置车辆黑白名单信息 NET_DVR_SendRemoteConfig
NET_DVR_GET_ALL_VEHICLE_CONTROL_LIST 获取所有车辆黑白名单信息 NET_DVR_GetNextRemoteConfig
NET_DVR_VEHICLELIST_CTRL_START 设置车辆黑白名单信息(批量) NET_DVR_SendRemoteConfig
NET_DVR_GET_TRAFFIC_DATA 获取交通数据 NULL
NET_DVR_GET_TRAFFIC_FLOW 获取交通流量 NULL
NET_DVR_PARKING_VEHICLE_SEND 停车车辆信息下发 NET_DVR_SendRemoteConfig
NET_DVR_PARKING_CARD_SEND 停车卡下发 NET_DVR_SendRemoteConfig
NET_DVR_GET_SENSOR_INFO 传感器信息查询 NET_DVR_GetNextRemoteConfig

See Also

NET_DVR_GetNextRemoteConfig  NET_DVR_SendRemoteConfig   NET_DVR_StopRemoteConfig