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_SCREEN_SPLICE_SET	9081	设置屏幕拼接参数	NULL	返回状态
NET_DVR_SCREEN_SPLICE_GET	9082	获取屏幕拼接参数	NULL	返回状态、信息数据
NET_DVR_SET_SCREEN_PARAM	9083	设置屏幕相关参数	NET_DVR_MSC_SCREEN_REMOTE_CFG	返回状态
NET_DVR_GET_SCREEN_PARAM	9084	获取屏幕相关参数	NET_DVR_MSC_SCREEN_PARAM_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	状态值	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	信息数据	获取屏幕拼接参数时对应结构体：NET_DVR_MSC_SPLICE_CFG 获取屏幕相关参数时对应结构体：NET_DVR_MSC_SCREEN_PARAM_CFG

dwBufLen

[out] 缓冲区大小

pUserData

[out] 用户数据

Return Values

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

Remarks

• 设置屏幕拼接参数时，按拼接屏序号设置，一个连接可以设置多个n*n的拼接屏，通过接口NET_DVR_SendRemoteConfig依次发送多个拼接屏的参数
。
• 设置屏幕相关参数，即将某个电视墙范围的屏幕的参数设置成一致；获取屏幕相关参数时，按从左到右、从上到下返回各个屏幕的参数，回调函数每次获取一个状态值或NET_DVR_MSC_SCREEN_PARAM_CFG结构。
• 调用该接口启动长连接远程配置后，还需要调用其他接口获取或者设置相关参数，如下表所示：

See Also

NET_DVR_SendRemoteConfig   NET_DVR_StopRemoteConfig