NET_DVR_RigisterDrawFun

预览画面叠加字符和图像，Linux下无此接口。

BOOL NET_DVR_RigisterDrawFun(
  LONG        lRealHandle,
  fDrawFun    cbDrawFun,
  DWORD       dwUser
);

Parameters

lRealHandle

[in] NET_DVR_RealPlay或NET_DVR_RealPlay_V30的返回值

cbDrawFun

[in] 画图回调函数

dwUser

[in] 用户数据

Callback Function

typedef void(CALLBACK *fDrawFun)(
  LONG      lRealHandle,
  HDC       hDc,
  DWORD     dwUser
);

Callback Function Parameters

lRealHandle

[out] 当前的预览句柄

hDc

[out] 画图DC

dwUser

[out] 用户数据

Return Values

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

Remarks

该接口主要完成注册回调函数，获得当前表面的device context。用户可以在这个DC上画图或写字，就好像在窗口的客户区DC上绘图，但这个DC不是窗口客户区的DC，而是播放器DirectDraw里的Off-Screen表面的DC。

如果调用接口NET_DVR_RealPlay_V30进行预览，参数bBlocked建议置1（TRUE），这样预览接口返回成功即可该调用该接口。 如果参数bBlocked置0，预览接口返回成功但图像还未正常显示，该接口会返回失败，获取错误号为12（调用次序错误）。

See Also

NET_DVR_RealPlay  NET_DVR_RealPlay_V30