设备网络SDK开发使用手册

NET_DVR_ClientSetVideoEffect

设置预览视频显示参数。

BOOL NET_DVR_ClientSetVideoEffect(
  LONG      lRealHandle,
  DWORD     dwBrightValue,
  DWORD     dwContrastValue,
  DWORD     dwSaturationValue,
  DWORD     dwHueValue
);

Parameters

lRealHandle
[in] NET_DVR_RealPlay或者NET_DVR_RealPlay_V30的返回值
dwBrightValue
[in] 亮度，取值范围[1,10]，小于1的值默认为1，大于10的值默认为10
dwContrastValue
[in] 对比度，取值范围[1,10]，小于1的值默认为1，大于10的值默认为10
dwSaturationValue
[in] 饱和度，取值范围[1,10]，小于1的值默认为1，大于10的值默认为10
dwHueValue
[in] 色度，取值范围[1,10]，小于1的值默认为1，大于10的值默认为10

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_NETWORK_ERRORDATA 11 传送的数据有误。发送给设备或者从设备接收到的数据错误，如远程参数配置时输入设备不支持的值。
NET_DVR_PARAMETER_ERROR 17 参数错误。SDK接口中给入的输入或输出参数为空。
NET_DVR_NOSUPPORT 23 设备不支持。

Remarks

该接口需要在预览的前提下才能调用，设置设备上对应通道的视频参数(远程配置设备上的参数，其他客户端相同通道的预览图像也会随之变化)。

SDK4.0及以后版本中，当设置的亮度、对比度等的值超过或低于限制值时接口不返回失败，将取最接近的上下限限制值作为实际的参数值。

See Also

NET_DVR_RealPlay  NET_DVR_RealPlay_V30