设备网络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

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

  • 多屏控制器,用户参数配置只支持NET_DVR_USER_INFO_V30中的sUserName和sPassword,其他参数都为无效参数。
  • dwCommand宏定义 dwCommand含义 lChannel lpOutBuffer对应结构体 宏定义值
    NET_DVR_GET_USERCFG_V30 获取用户参数 无效 NET_DVR_USER_V30 1006
    NET_DVR_GET_SCREEN_WINCFG 获取单个窗口参数 窗口号 NET_DVR_SCREEN_WINCFG 1603
    NET_DVR_LAYOUTLIST_GET 获取场景列表 4字节保留 NET_DVR_LAYOUT_LIST 1605
    NET_DVR_INPUTLIST_GET 获取输入信号源列表 4字节保留 NET_DVR_INPUTSTREAM_LIST 1608
    NET_DVR_OUTPUT_GET 获取输出参数 集中式多屏控制器4字节保留;分布式多屏控制器表示墙号 NET_DVR_OUTPUTCFG 1611
    NET_DVR_GET_OSDCFG 获取虚拟LED参数 虚拟LED序号:集中式多屏控制器4字节表示序号;分布式多屏控制器高2字节表示墙号,低2字节表示序号 NET_DVR_OSDCFG 1613
    NET_DVR_BIGSCREEN_GETSERIAL 获取大屏串口信息 无效 NET_DVR_SERIAL_CONTROL 1614
    NET_DVR_GET_VCS_USER_CFG 获取用户信息 用户号,从1开始 NET_DVR_VCS_USER_INFO 1623
    NET_DVR_GET_CURRENT_SCENE_V41 获取当前电视墙中正在使用的场景 电视墙墙号,从1开始 NET_DVR_WALLSCENECFG 9022

    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 程序异常。

    See Also

    NET_DVR_SetDVRConfig  NET_DVR_GetLastError