设备网络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] 要设置的设备个数，设为1
lpInBuffer: [in] 配置条件缓冲区
dwInBufferSize: [in] 缓冲区长度
lpStatusList: [out] 错误信息列表，和要查询的监控点一一对应，例如lpStatusList[2]就对应lpInBuffer[2]，由用户分配内存，每个错误信息为4个字节(1个32位无符号整数值)，参数值：0或者1表示成功，其他值为失败对应的错误号
lpOutBuffer: [out] 设备返回的参数内容，和要查询的监控点一一对应。如果某个监控点对应的lpStatusList信息为大于1的值，对应lpOutBuffer的内容就是无效的
dwOutBufferSize: [in] 输出缓冲区大小

Return Values

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

Remarks

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

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

dwCommand宏定义	dwCommand含义	lpInBuffer对应结构体	lpOutBuffer对应结构体	宏定义值
NET_DVR_SCREEN_INDEX_GET	获取屏幕索引相关参数	dwCount个4字节索引号	dwCount个NET_DVR_SCREEN_INDEX_CFG	9080
NET_DVR_GET_SCREEN_POSITION	获取屏幕位置参数	dwCount个4字节索引号	dwCount个NET_DVR_VIDEOWALLDISPLAYPOSITION	9090
NET_DVR_GET_CURRENT_SCREEN_SCENE	获取当前屏幕场景号(dwCount为1)	NET_DVR_VIDEO_WALL_INFO	4字节场景号	9092
NET_DVR_GET_SCREEN_SCENE_PARAM	获取屏幕场景参数	dwCount个NET_DVR_VIDEO_WALL_INFO	dwCount个NET_DVR_WALLSCENECFG	9093
NET_DVR_GET_SWITCH_CFG	获取定时开关机参数(dwCount为1)	NET_DVR_VIDEO_WALL_AREA	NET_DVR_TIME_SWITCH_CFG	9086
NET_DVR_GET_EXTERNAL_MATRIX_CFG	获取矩阵信息	dwCount个4字节矩阵ID	dwCount个NET_DVR_EXTERNAL_MATRIX_CFG	1619

dwCount为0xffffffff时，lpInBuffer为NULL，dwInBufferSize为0，表示获取所有的相关信息，并且此时lpOutBuffer的前4个字节为返回的实际信息个数，4字节后才是返回的具体信息，因此，lpOutBuffer缓冲区的大小需要比列表所述大小多4个字节。其中，NET_DVR_SCREEN_INDEX_GET不支持全部获取。

上述“4字节索引号”取值：1字节设备号+1字节保留+2字节索引序号，设备号和索引序号从1开始。

NET_DVR_GetDeviceConfig

Parameters

Return Values

Remarks

See Also