设备网络SDK开发使用手册

NET_DVR_SetDeviceConfig

批量设置设备配置信息(带发送数据)。

BOOL NET_DVR_SetDeviceConfig(
  LONG      lUserID,
  DWORD     dwCommand,
  DWORD     dwCount,
  LPVOID    lpInBuffer,
  DWORD     dwInBufferSize,
  LPVOID    lpStatusList,
  LPVOID    lpInParamBuffer,
  DWORD     dwInParamBufferSize
);

Parameters

lUserID
[in] NET_DVR_Login_V40等登录接口的返回值
dwCommand
[in] 设备配置命令,参见配置命令
dwCount
[in] 一次要设置的子设备个数
lpInBuffer
[in] 配置条件缓冲区
dwInBufferSize
[in] 配置条件缓冲区长度
lpStatusList
[out] 错误信息列表,和要查询的监控点一一对应,例如lpStatusList[2]就对应lpInBuffer[2],由用户分配内存, 每个错误信息为4个字节(1个32位无符号整数值),参数值:0或者1表示成功,其他值为失败对应的错误号
lpInParamBuffer
[in] 需要设置给设备的参数内容,和要查询的监控点一一对应。如果某个监控点对应的lpStatusList信息为大于1的值,表示对应的lpInBuffer设置失败,为0或1则表示设置成功
dwInParamBufferSize
[in] 设置内容缓冲区大小

Return Values

TRUE表示成功,但不代表每一个配置都成功,哪一个成功,对应查看lpStatusList[n]值;FALSE表示全部失败。接口返回失败请调用NET_DVR_GetLastError获取错误码,通过错误码判断出错原因。

Remarks

  • 该接口是带有发送数据的批量设置配置信息的通用接口。lpInBuffer指定需要设置的dwCount个监控点信息,lpOutBuffer保存将要设置的dwCount个监控点的配置信息。
  • 不同的设置功能对应不同的结构体和命令号,如下表所示:

    dwCommand宏定义 dwCommand含义 lpInBuffer对应结构体 lpInParamBuffer对应结构体 宏定义值
    NET_DVR_SCREEN_INDEX_SET 设置屏幕索引相关参数 dwCount个4字节索引号 dwCount个NET_DVR_SCREEN_INDEX_CFG 9079
    NET_DVR_SET_SCREEN_POSITION 设置屏幕位置参数 dwCount个4字节索引号 dwCount个NET_DVR_VIDEOWALLDISPLAYPOSITION 9089
    NET_DVR_SET_SCREEN_SCENE_PARAM 设置屏幕场景参数 dwCount个NET_DVR_VIDEO_WALL_INFO dwCount个NET_DVR_WALLSCENECFG 9094
    NET_DVR_SET_SWITCH_CFG 设置定时开关机参数(dwCount为1) NET_DVR_VIDEO_WALL_AREA NET_DVR_TIME_SWITCH_CFG 9085
    NET_DVR_SET_EXTERNAL_MATRIX_CFG 设置矩阵信息 dwCount个4字节矩阵ID dwCount个NET_DVR_EXTERNAL_MATRIX_CFG 1620
  • 上述“4字节索引号”取值:1字节设备号+1字节保留+2字节索引序号,设备号和索引序号从1开始。
  • See Also

    NET_DVR_GetDeviceConfig  NET_DVR_GetLastError