设备网络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_Login_V30）返回的设备信息（NET_DVR_DEVICEINFO_V30）获取模拟通道个数（byChanNum）、模拟通道起始通道号（byStartChan）和设备支持的最大IP通道数（byIPChanNum+ byHighDChanNum*256）、数字通道起始通道号（byStartDChan）。

    • dwCommand宏定义 dwCommand含义 lChannel lpOutBuffer对应结构体 宏定义值
    NET_DVR_GET_SMSRELATIVEPARA_V50 获取短信相关参数 通道号 NET_DVR_SMSRELATIVEPARAM_V50 2512
    NET_DVR_GET_LOGO_OVERLAYCFG 获取LOGO图片叠加参数 通道号 NET_DVR_LOGO_OVERLAYCFG 3234
    NET_DVR_GET_RECORDING_AUTO_TRACK_CFG 获取SDI自动跟踪配置信息 无效 NET_DVR_AUTO_TRACK_CFG 6307
    NET_DVR_GET_RECORDING_PUBLISH_CFG 获取一键发布信息 无效 NET_DVR_PUBLISH_CFG 6309
    NET_DVR_GET_RECORDING_END_TIME 获取录播剩余时间(结束时间点) 无效 NET_DVR_TIME_EX 6312
    NET_DVR_GET_COURSE_INDEX_CFG 获取课程信息索引 课程索引号，从1开始 NET_DVR_COURSE_RECORDING_INFO 6316
    NET_DVR_GET_PPT_CHANNEL 获取PPT支持通道号 无效 NET_DVR_PPT_CHANNEL_CFG 6318
    NET_DVR_GET_PPT_DETECT_CFG 获取PPT检测参数 通道号 NET_DVR_PPT_DETECT_CFG 6319
    NET_DVR_GET_RECORDINGHOST_CFG 获取录播主机配置信息 无效 NET_DVR_RECORDING_HOST_CFG 6321
    NET_DVR_GET_BACKUP_RECORD_CFG 获取一键备份配置信息 无效 NET_DVR_BACKUP_RECORD_PARAM 6323
    NET_DVR_GET_MIX_AUDIOIN_CFG 获取混音输入口参数配置 音频输入口号，从1开始 NET_DVR_MIX_AUDIOIN_CFG 6351
    NET_DVR_GET_MIX_AUDIOOUT_CFG 获取混音输出口参数配置 音频输出口号，从1开始 NET_DVR_MIX_AUDIOOUT_CFG 6353
    NET_DVR_GET_AUDIOIN_VOLUME_CFG 获取音频输入口音量调节参数 音频输入口号，从1开始 NET_DVR_VOLUME_CFG 6355
    NET_DVR_GET_AUDIOOUT_VOLUME_CFG 获取音频输出口音量调节参数 音频输出口号，从1开始 NET_DVR_VOLUME_CFG 6369
    NET_DVR_GET_VIDEOOUT_RESOLUTION_CFG 获取设备本地视频输出口分辨率 视频输出口，从1开始 NET_DVR_VIDEOOUT_RESOLUTION_CFG 6367
    NET_DVR_GET_MEMU_OUTPUT_MODE 获取菜单输出模式 无效 NET_DVR_MENU_OUTPUT_MODE 155649

    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