设备网络SDK开发使用手册

NET_DVR_GetDVRConfig

获取设备的配置信息。

BOOL NET_DVR_GetDVRConfig(
  LONG     lUserID,
  DWORD    dwCommand,
  LONG     lChannel,
  LPVOID   lpOutBuffer,
  DWORD    dwOutBufferSize,
  LPDWORD  lpBytesReturned
);

Parameters

lUserID
[in] NET_DVR_Login_V40等登录接口的返回值
dwCommand
[in] 设备配置命令,详见“Remarks”说明
lChannel
[in] 通道号,不同的命令对应不同的取值,如果该参数无效则置为0xFFFFFFFF即可,详见“Remarks”说明
lpOutBuffer
[out] 接收数据的缓冲指针
dwOutBufferSize
[in] 接收数据的缓冲长度(以字节为单位),不能为0
lpBytesReturned
[out] 实际收到的数据长度指针,不能为NULL

Remarks

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

dwCommand宏定义 dwCommand含义 lChannel lpOutBuffer对应结构体 宏定义值
NET_DVR_GET_RS232CFG_V30 获取232串口参数 无效 NET_DVR_RS232CFG_V30 1036
NET_DVR_GET_SENSOR_CFG 获取模拟量参数 模拟量通道,从1开始 NET_DVR_SENSOR_INFO 1181
NET_DVR_GET_ALARMIN_PARAM 获取防区参数 防区号,从0开始 NET_DVR_ALARMIN_PARAM 1183
NET_DVR_GET_ALARMIN_PARAM_V50 获取防区参数V50 防区号,从0开始 NET_DVR_ALARMIN_PARAM_V50 1201
NET_DVR_GET_ALARMOUT_PARAM 获取触发器参数 触发器号,从0开始 NET_DVR_ALARMOUT_PARAM 1185
NET_DVR_GET_SIREN_PARAM 获取警号参数 1个警号,设为0 NET_DVR_SIREN_PARAM 1187
NET_DVR_GET_ALARM_RS485CFG 获取报警主机RS485参数 485通道号,从1开始 NET_DVR_ALARM_RS485CFG 1189
NET_DVR_GET_ALARMHOST_MAIN_STATUS_V40 获取报警主机主要状态 无效 NET_DVR_ALARMHOST_MAIN_STATUS_V40 2072
NET_DVR_GET_ALARMHOST_OTHER_STATUS 获取报警主机其他状态 无效 NET_DVR_ALARMHOST_OTHER_STATUS 1191
NET_DVR_GET_ALARMHOST_OTHER_STATUS_V50 获取报警主机其他状态V50 无效 NET_DVR_ALARMHOST_OTHER_STATUS_V50 2228
NET_DVR_GET_ALARMHOST_ENABLECFG 获取报警主机使能状态 无效 NET_DVR_ALARMHOST_ENABLECFG 1193
NET_DVR_GET_GATEWAY_CFG 获取门禁参数 门禁号,从1开始 NET_DVR_GATEWAY_CFG 1196
NET_DVR_GET_ALARMDIALMODECFG 获取报警主机拨号参数 无效 NET_DVR_ALARMHOSTDIALCFG 1198
NET_DVR_GET_ALARMHOSTDIALSETUPMODE 获取报警主机拨号启用方式 无效 NET_DVR_ALARMHOSTDIALSETUPMODE 1204
NET_DVR_GET_ALARMHOSTSUBSYSTEM_CFG 获取子系统参数,子系统的数量从能力集获取 子系统号,从1开始 NET_DVR_ALARMSUBSYSTEMPARAM 2001
NET_DVR_GET_ALARMHOST_WIRELESS_NETWORK_CFG 获取无线网络参数配置 无效 NET_DVR_ALARMHOST_WIRELESS_NETWORK_CFG 2005
NET_DVR_GET_ALARMHOST_NETCFG_V50 获取报警主机网络参数配置V50 网卡号:1-主网卡,2-扩展网卡,3-无线网卡 NET_DVR_ALARMHOST_NETCFG_V50 2224
NET_DVR_GET_LED_SCREEN_CFG 获取LED屏幕参数 串口号,从0开始 NET_DVR_LED_SCREEN_CFG 2009
NET_DVR_GET_LED_CONTENT_CFG 获取LED屏显内容 串口号,从0开始 NET_DVR_LED_CONTENT_CFG 2011
NET_DVR_GET_LED_TIMER_SWITCH 获取LED屏定时开关参数 串口号,从0开始 NET_DVR_LED_SWITCH_TIME 2015
NET_DVR_GET_LED_TIMER_BRIGHTNESS 获取分时LED屏亮度 串口号,从0开始 NET_DVR_LED_BRIGHTNESS_STEP 2018
NET_DVR_GET_ALARMHOST_AUDIO_ASSOCIATE_ALARM 获取音频跟随报警事件 无效 NET_DVR_ALARMHOST_AUDIO_ASSOCIATE_ALARM 2021
NET_DVR_GET_LED_STATUS 获取LED屏状态 串口号,从0开始 NET_DVR_LED_STATUS 2023
NET_DVR_GET_ALARMHOST_SUBSYSTEM_CFG_EX 获取子系统扩展参数,子系统的数量从能力集获取 子系统号,从1开始 NET_DVR_SUBSYSTEM_PARAM_EX 2030
NET_DVR_GET_ALARMHOST_PRINTER_CFG 获取打印机配置参数 无效 NET_DVR_ALARMHOST_PRINTER_CFG 2032
NET_DVR_GET_ALARMHOST_EVENT_TRIG_ALARMOUT_CFG 获取事件触发触发器配置 从0开始,触发器通道数从能力集获取 NET_DVR_TRIGGER_EVENT 2037
NET_DVR_GET_ALARMHOST_FAULT_CFG 获取故障处理配置信息 无效 NET_DVR_ALARMHOST_FAULT_CFG 2039
NET_DVR_GET_SAFETYCABIN_WORK_MODE 获取防护舱工作模式参数 无效 NET_DVR_SAFETYCABIN_WORK_MODE 2044
NET_DVR_GET_SAFETYCABIN_PERSON_SIGNAL_CFG 获取防护舱人信号探测参数 无效 NET_DVR_SAFETYCABIN_PERSON_SIGNAL_CFG 2046
NET_DVR_GET_ALARMHOST_MODULE_CFG 获取模块信息 模块号(模块地址):1~253 NET_DVR_ALARMHOST_MODULE_CFG 2048
NET_DVR_GET_ALARMHOST_EXTERNAL_DEVICE_LIMIT_VALUE 获取外接设备报警限值 高2字节表示485通道号,低2字节表示槽位号,都从1开始 NET_DVR_ALARMHOST_EXTERNAL_DEVICE_LIMIT_VALUE 2052
NET_DVR_GET_ALARMHOST_SENSOR_JOINT_CFG 获取模拟量关联配置 模拟量号,从1开始 NET_DVR_ALARMHOST_SENSOR_JOINT_CFG 2053
NET_DVR_GET_ALARMHOST_RS485_SLOT_CFG 获取报警主机485槽位参数 高2字节表示485通道号,低2字节表示槽位号,都从1开始 NET_DVR_ALARMHOST_RS485_SLOT_CFG 2056
NET_DVR_GET_ALARMHOST_SENSOR_VALUE 获取模拟量实时数据 模拟量号 NET_DVR_SENSOR_ALARM 2063
NET_DVR_GET_ONE_OUTPUT_SCH_RULECFG_V40 获取单个时控输出参数 规则索引,从1开始 NET_DVR_ONE_OUTPUT_SCH_RULECFG_V40 2078
NET_DVR_GET_OUTPUT_SCHEDULE_RULECFG_V40 获取时控输出参数 无效 NET_DVR_OUTPUT_SCHEDULE_RULECFG_V40 2080
NET_DVR_GET_DEVICE_SELF_CHECK_STATE 获取设备自检状态 无效 NET_DVR_DEVICE_SELF_CHECK_STATE 2707
NET_DVR_GET_SUBSYSTEM_ALARM 获取子系统定时布撤防参数 无效 NET_DVR_SUBSYSTEM_ALARM 1211
NET_DVR_GET_WHITELIST_ALARM 获取白名单参数 白名单索引号,从1开始 NET_DVR_ALARM_PHONECFG 1215
NET_DVR_GET_PRIOR_ALARM 获取优先计划子系统定时布撤防参数 无效 NET_DVR_PRIOR_SCHEDTIME 1224
NET_DVR_GET_TAMPER_ALARMIN_PARAM 获取防区防拆参数 防区号,从0开始 NET_DVR_TAMPER_ALARMIN_PARAM 1226
NET_DVR_GET_ALARM_CAPTRUE_CFG 获取报警抓图参数 通道号 NET_DVR_ALARM_CAPTRUE_CFG 2074
NET_DVR_GET_REMOTECONTROLLER_PERMISION_CFG 获取遥控器权限参数 遥控器用户索引 NET_DVR_REMOTECONTROLLER_PERMISSION_CFG 2200
NET_DVR_GET_PREVIEW_DELAY_CFG 获取延迟预览参数配置 通道号 NET_DVR_PREVIEW_DELAY_CFG 2206
NET_DVR_GET_ZONE_CHANNEL_LINKAGE_CFG 获取防区联动视频通道配置 防区号,从0开始 NET_DVR_ZONE_CHANNEL_LINKAGE_CFG 2208
NET_DVR_GET_CENTER_SERVER_CFG 获取报警中心服务器配置 无效 NET_DVR_CENTER_SERVER_CFG 2210
NET_DVR_GET_ALARM_CHAN_ABLITITY 获取报警相关通道参数能力 无效 NET_DVR_ALARM_CHAN_ABLITITY 2714
NET_DVR_GET_ALARMCENTER_NETCFG 获取报警中心网络参数配置 无效 NET_DVR_ALARMCENTER_NETCFG 2715
NET_DVR_GET_SAFETYCABIN_STATE 获取防护舱状态 无效 NET_DVR_ALARMHOST_SAFETYCABINSTATE 2197
NET_DVR_GET_RS485_CASCADE_CFG 获取RS485级联设备配置 无效 NET_DVR_RS485_CASCADE_CFG 2198
NET_DVR_GET_RS485_PROTOCOL_VERSION 获取RS485协议库版本信息 无效 NET_DVR_RS485_PROTOCOL_VERSION 10301
NET_DVR_GET_AIR_CONDITION_PARAM 获取空调参数 高2字节表示485通道号,低2字节表示槽位号,都从1开始 NET_DVR_AIR_CONDITION_PARAM 2711

Return Values

TRUE表示成功,FALSE表示失败。接口返回失败请调用NET_DVR_GetLastError获取错误码,通过错误码判断出错原因。

以下是该接口可能返回的错误值

错误类型 错误值 错误信息
NET_DVR_NOERROR 0 没有错误。
NET_DVR_NOINIT 3 SDK未初始化。
NET_DVR_VERSIONNOMATCH 6 版本不匹配。SDK和设备的版本不匹配。
NET_DVR_NETWORK_FAIL_CONNECT 7 连接设备失败。设备不在线或网络原因引起的连接超时等。
NET_DVR_NETWORK_SEND_ERROR 8 向设备发送失败。
NET_DVR_NETWORK_RECV_ERROR 9 从设备接收数据失败。
NET_DVR_NETWORK_RECV_TIMEOUT 10 从设备接收数据超时。
NET_DVR_ORDER_ERROR 12 调用次序错误。
NET_DVR_PARAMETER_ERROR 17 参数错误。SDK接口中给入的输入或输出参数为空。
NET_DVR_ALLOC_RESOURCE_ERROR 41 SDK资源分配错误。
NET_DVR_NOENOUGH_BUF 43 缓冲区太小。接收设备数据的缓冲区或存放图片缓冲区不足。
NET_DVR_CREATESOCKET_ERROR 44 创建SOCKET出错。
NET_DVR_USERNOTEXIST 47 用户不存在。注册的用户ID已注销或不可用。
NET_DVR_BINDSOCKET_ERROR 72 绑定套接字失败。
NET_DVR_SOCKETCLOSE_ERROR 73 socket连接中断,此错误通常是由于连接中断或目的地不可达。
NET_DVR_PROGRAM_EXCEPTION 76 程序异常。

Remarks

1.设备所支持的事件类型从能力集获取,事件触发触发器开启和事件触发触发器关闭为互斥,不能将开启和关闭选为同一个事件。

2.全局事件:bit0-交流电掉电,bit1-电池电压低,bit2-电话线掉线,bit3-有线网络异常,bit4-无线网络异常,bit5-硬盘故障, bit6-3G/4G信号异常, bit7-(模块链接)第三方主机掉线

3.子系统事件:bit0-进入延时,bit1-退出延时,bit2-布防,bit3-撤防,bit4-报警,bit5-消除报警记忆,bit6-报警恢复,bit7-防区防拆,bit8-防区防拆恢复

4. DS19-AXX和DS19-SXX系列,子系统处于布防状态下不能设置。

5. DS19-AXX和DS19-SXX系列,主机处于编程模式,步测模式下不能设置。

6.事件触发触发器和事件触发防区中不能包含同一个事件,例如,“全局事件触发触发器开启”中选择了交流电断电这个事件,那么“全局事件触发触发器关闭”中就不能再选择交流电断电事件。否则配置失败。

7.wExpandAlarmInNum大于0表示支持防区编号功能,此时NET_DVR_ALARMIN_PARAM中的byJointSubSystem,byModuleStatus,wModuleAddress,byModuleChan,byModuleType,wZoneIndex有效。支持“获取子系统内防区”,“自动搜索”,“自动注册”功能。

8.本地防区的byJointSubSystem,byModuleStatus,wModuleAddress,byModuleChan,byModuleType,wZoneIndex参数不可修改。

9.下列情况下防区参数不能被修改:防区处于布防状态,或者防区所在子系统处于布防状态下,或者主机处于编程模式,或者主机处于步测模式。

10.DS-19AXX,DS-19SXX系列主机,修改防区类型时,如果该防区处于旁路状态,则会自动旁路恢复。其他系列主机旁路状态下不允许修改防区参数,此时修改参数则返回错误29(设备操作失败)。

11.防区类型是24小时类的防区,则不允许设置byArrayBypass为1(支持组旁路)

See Also

NET_DVR_SetDVRConfig