设备网络SDK开发使用手册

NET_DVR_GetFileByTime

按时间下载录像文件。

LONG NET_DVR_GetFileByTime(
  LONG              lUserID,
  LONG              lChannel,
  LPNET_DVR_TIME    lpStartTime,
  LPNET_DVR_TIME    lpStopTime,
  char              *sSavedFileName
);

Parameters

lUserID: [in] NET_DVR_Login_V40的返回值
lChannel: [in] 通道号
lpStartTime: [in] 开始时间
lpStopTime: [in] 结束时间
sSavedFileName: [in] 下载后保存到PC机的文件路径，需为绝对路径

Return Values

-1表示失败，其他值作为NET_DVR_StopGetFile等函数的参数。接口返回失败请调用NET_DVR_GetLastError获取错误码，通过错误码判断出错原因。

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

错误类型	错误值	错误信息
NET_DVR_NOERROR	0	没有错误。
NET_DVR_PASSWORD_ERROR	1	用户名密码错误。注册时输入的用户名或者密码错误。
NET_DVR_NOINIT	3	SDK未初始化。
NET_DVR_OVER_MAXLINK	5	连接到设备的用户个数超过最大。
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_COMMANDTIMEOUT	14	设备命令执行超时。
NET_DVR_PARAMETER_ERROR	17	参数错误。SDK接口中给入的输入或输出参数为空。
NET_DVR_CREATEFILE_ERROR	34	创建文件出错。本地录像、保存图片、获取配置文件和远程下载录像时创建文件失败。
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连接中断，此错误通常是由于连接中断或目的地不可达。

Remarks

该接口指定了当前要下载的录像文件，调用成功后，还需要调用NET_DVR_PlayBackControl接口的开始播放控制命令（NET_DVR_PLAYSTART）才能实现下载。
V5.0.3.2或以后版本，通过该接口保存录像，保存的录像文件数据超过文件最大限制字节数（默认为1024MB），SDK会自动切片，即新建文件进行保存，文件名命名规则为“在接口传入的文件名基础上增加数字标识(例如：*_1.mp4、*_2.mp4)”。可以调用NET_DVR_GetSDKLocalCfg、NET_DVR_SetSDKLocalCfg(配置类型：NET_DVR_LOCAL_CFG_TYPE_GENERAL)获取和设置切片模式和文件最大限制字节数。

Reference Interface

扩展接口可见
NET_DVR_GetFileByTime_V40

NET_DVR_GetFileByTime

Parameters

Return Values

Remarks

See Also

Reference Interface