设备网络SDK开发使用手册

NET_DVR_GetDeviceConfig

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

BOOL NET_DVR_GetDeviceConfig(
  LONG      lUserID,
  DWORD     dwCommand,
  DWORD     dwCount,
  LPVOID    lpInBuffer,
  DWORD     dwInBufferSize,
  LPVOID    lpStatusList,
  LPVOID    lpOutBuffer,
  DWORD     dwOutBufferSize
);

Parameters

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

Return Values

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

Remarks

该接口是带有发送数据的批量获取监控点配置信息的通用接口。lpInBuffer指定需要获取的dwCount个配置信息,lpOutBuffer保存获取得到的dwCount个配置信息。

不同的获取功能对应不同的结构体和命令号,如下表所示:

dwCommand宏定义 dwCommand含义 lpInBuffer对应结构体 lpOutBuffer对应结构体 宏定义值
NET_DVR_GET_LIMITCFG 获取限位参数配置 dwCount个NET_DVR_PTZ_LIMITCOND dwCount个NET_DVR_PTZ_LIMITCFG 3276
NET_DVR_GET_PRIVACY_MASKSCFG 获取云台隐私遮蔽参数 dwCount个NET_DVR_PRIVACY_MASKS_COND dwCount个NET_DVR_PRIVACY_MASKS_CFG 3285

See Also

NET_DVR_SetDeviceConfig  NET_DVR_GetLastError