设备网络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_DVR_GET_REGISTER_INFO 2511 获取身份登记信息 NET_DVR_ID_CARD_BLACK_LIST_COND 返回状态、进度、信息数据
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] 配置状态,具体定义如下所示:
enum _NET_SDK_CALLBACK_TYPE_{
  NET_SDK_CALLBACK_TYPE_STATUS   = 0,
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  NET_SDK_CALLBACK_TYPE_DATA
}NET_SDK_CALLBACK_TYPE
NET_SDK_CALLBACK_TYPE_STATUS
回调状态值
NET_SDK_CALLBACK_TYPE_PROGRESS
回调进度值
NET_SDK_CALLBACK_TYPE_DATA
回调数据内容
lpBuffer
[out] 存放数据的缓冲区指针,具体内容跟dwType相关,详见列表
dwType 含义 lpBuffer对应内容
NET_SDK_CALLBACK_TYPE_STATUS 状态值 前4个字节为状态值(dwStatus):
typedef enum
{
  NET_SDK_CALLBACK_STATUS_SUCCESS = 1000,//成功
  NET_SDK_CALLBACK_STATUS_PROCESSING,    //处理中
  NET_SDK_CALLBACK_STATUS_FAILED         //失败
}NET_SDK_CALLBACK_STATUS_NORMAL;
NET_SDK_CALLBACK_TYPE_PROGRESS 进度值 lpBuffer的值表示进度(DWORD)
NET_SDK_CALLBACK_TYPE_DATA 信息数据 lpBuffer的值表示信息数据
NET_DVR_GET_REGISTER_INFO时,对应结构体:NET_DVR_ID_CARD_BLACK_LIST_CFG
dwBufLen
[out] 缓冲区大小
pUserData
[out] 用户数据

Return Values

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

Remarks

See Also

NET_DVR_StopRemoteConfig