NET_DVR_PlayBackControl

控制录像下载的状态。

BOOL NET_DVR_PlayBackControl(
  LONG     lPlayHandle,
  DWORD    dwControlCode,
  DWORD    dwInValue,
  DWORD    *lpOutValue
);

Parameters

lPlayHandle

[in] 下载句柄，NET_DVR_GetFileByName或NET_DVR_GetFileByTime的返回值

dwControlCode

[in] 控制录像下载状态命令，见下表

宏定义	宏定义值	含义
NET_DVR_PLAYSTART	1	开始下载
NET_DVR_PLAYPAUSE	3	暂停下载
NET_DVR_PLAYRESTART	4	恢复下载
NET_DVR_PLAYSETPOS	12	改变文件下载的进度（按文件下载时有效）
NET_DVR_PLAYGETPOS	13	获取文件下载的进度（按文件下载时有效）
NET_DVR_GETTOTALFRAMES	16	获取当前下载文件总的帧数(按文件下载时有效)
NET_DVR_GETTOTALTIME	17	获取当前下载文件总的时间(按文件下载时有效)
NET_DVR_SETSPEED	24	设置下载速度，流控范围：0~32Mbps

dwInValue

[in] 设置的参数，如设置文件下载的进度(命令值NET_DVR_PLAYSETPOS)时，此参数表示进度值；如开始下载(命令值NET_DVR_PLAYSTART)时，此参数表示断点续传的文件位置（Byte）

lpOutValue

[out] 获取的参数，如获取当前下载文件总的时间（命令值NET_DVR_GETTOTALTIME ），此参数就是得到的总时间

Return Values

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

Remarks

该接口中的第三个参数是否需要输入数值与控制命令有关，NET_DVR_PLAYSETPOS命令下此参数表示下载的进度；当控制命令是开始下载（即NET_DVR_PLAYSTART）时，第三个参数的值表示下载当前文件的偏移量，若该值为0表示从文件的起始位置下载，若该值不为0则表示断点续传的文件位置（Byte）(目前只有DS-90xx和DS-81xx硬盘录像机支持断点续传功能)。
该接口中的第四个参数表示当前控制命令操作所获取到的相应的参数，控制命令中的NET_DVR_PLAYGETPOS、NET_DVR_GETTOTALFRAMES和NET_DVR_GETTOTALTIME都能通过该参数得到对应的值。
进度值的取值范围为0-100，获取文件下载进度时，0-100表示正常的进度值，大于100的值表示回放或者下载异常。

See Also

NET_DVR_GetFileByName  NET_DVR_GetFileByTime

Reference Interface

扩展接口可见

NET_DVR_PlayBackControl_V40