海康威视SDK的常用函数接口

最新推荐文章于 2025-04-07 13:20:53 发布

weixin_47364204

最新推荐文章于 2025-04-07 13:20:53 发布

阅读量9.6k

点赞数 10

本文链接：https://blog.csdn.net/weixin_47364204/article/details/108537271

版权

锐度值设置

◆ MV_CC_SetSharpness()

MV_CAMCTRL_API int __stdcall MV_CC_SetSharpness	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置锐度

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的锐度
返回

成功，返回MV_OK ,并且相机锐度将会更改为相应值；失败，返回错误码

◆ MV_CC_GetSharpness()

MV_CAMCTRL_API int __stdcall MV_CC_GetSharpness	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取锐度

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机锐度结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照如下接口 MV_CC_GetWidth()

图像宽度值设置

MV_CC_GetWidth()

MV_CAMCTRL_API int __stdcall MV_CC_GetWidth	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取图像宽度

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机宽度的信息结构体指针返回的pstValue结构体的意义：变量意义
- unsigned int nCurValue 代表相机当前的宽度值
- unsigned int nMax 表示相机允许的最大可设置的宽度值
- unsigned int nMin 表示相机允许的最小可设置的宽度值
- unsigned int nInc 表示相机设置的宽度增量必须是nInc的倍数，否则无效
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

其他整型结构体参数的接口可参照此接口

曝光值上下限设置

◆ MV_CC_SetAutoExposureTimeLower()

MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeLower	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置曝光值下限

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的曝光值下限
返回

成功，返回MV_OK ,并且相机曝光下限将会更改为相应值；失败，返回错误码

◆ MV_CC_GetAutoExposureTimeLower()

MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeLower	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取曝光下限

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机曝光值下限结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAutoExposureTimeUpper()

MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeUpper	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置曝光值上限

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的曝光值上限
返回

成功，返回MV_OK ,并且相机曝光上限将会更改为相应值；失败，返回错误码

◆ MV_CC_GetAutoExposureTimeUpper()

MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeUpper	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取曝光上限

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机曝光值上限结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

亮度值设置

◆ MV_CC_GetBrightness()

MV_CAMCTRL_API int __stdcall MV_CC_GetBrightness	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取亮度值

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机亮度结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBrightness()

MV_CAMCTRL_API int __stdcall MV_CC_SetBrightness	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置亮度值

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的亮度值
返回

成功，返回MV_OK ,并且相机亮度将会更改为相应值；失败，返回错误码

帧率设置

◆ MV_CC_GetFrameRate()

MV_CAMCTRL_API int __stdcall MV_CC_GetFrameRate	(	IN void *	handle,
		IN OUT MVCC_FLOATVALUE *	pstValue
	)

获取帧率

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机帧率的信息结构体指针返回的pstValue结构体的意义：变量意义 - float fCurValue 表示相机当前的帧率 - float fMax 表示相机允许设置的最大帧率 float fMin 表示相机允许设置的最小帧率
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

其他浮点型结构体参数的接口可参照此接口

◆ MV_CC_SetFrameRate()

MV_CAMCTRL_API int __stdcall MV_CC_SetFrameRate	(	IN void *	handle,
		IN const float	fValue
	)

设置帧率

参数

handle[IN] 相机句柄 fValue[IN] 想要设置的相机帧率
返回

成功，返回MV_OK ,并且相机帧率将会更改为相应值；失败，返回错误码

增益值设置

◆ MV_CC_GetGain()

MV_CAMCTRL_API int __stdcall MV_CC_GetGain	(	IN void *	handle,
		IN OUT MVCC_FLOATVALUE *	pstValue
	)

获取增益

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机增益的信息结构体指针返回的pstValue结构体的意义：

变量意义
- float fCurValue 表示相机当前的增益
- float fMax 表示相机允许设置的最大增益
- float &nbsp 表示相机允许设置的最小增益
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

其他浮点型结构体参数的接口可参照此接口

◆ MV_CC_SetGain()

MV_CAMCTRL_API int __stdcall MV_CC_SetGain	(	IN void *	handle,
		IN const float	fValue
	)

设置增益

参数

handle[IN] 相机句柄

fValue[IN] 想要设置的相机增益
返回

成功，返回MV_OK ,并且相机增益将会更改为相应值；失败，返回错误码

曝光时间设置

◆ MV_CC_GetExposureTime()

MV_CAMCTRL_API int __stdcall MV_CC_GetExposureTime	(	IN void *	handle,
		IN OUT MVCC_FLOATVALUE *	pstValue
	)

获取曝光时间

参数

handle[IN] 相机句柄

pstValue[IN][OUT] 返回给调用者有关相机曝光时间的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码

◆ MV_CC_SetExposureTime()

MV_CAMCTRL_API int __stdcall MV_CC_SetExposureTime	(	IN void *	handle,
		IN const float	fValue
	)

设置曝光时间

参数

handle[IN] 相机句柄 fValue[IN] 想要设置的曝光时间
返回

成功，返回MV_OK ,并且相机帧率将会更改为相应值；失败，返回错误码

像素格式设置

◆ MV_CC_GetPixelFormat()

MV_CAMCTRL_API int __stdcall MV_CC_GetPixelFormat	(	IN void *	handle,
		IN OUT MVCC_ENUMVALUE *	pstValue
	)

获取像素格式

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者的有关像素格式的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码

◆ MV_CC_SetPixelFormat()

MV_CAMCTRL_API int __stdcall MV_CC_SetPixelFormat	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置像素格式

参数

handle[IN] 相机句柄 nValue[IN] 要设置的像素格式对应的整型值，调用此接口时可以直接填写枚举值，如 MV_CC_SetPixelFormat() ;
返回

成功，返回MV_OK ,并且相机像素格式将会更改为相应值；失败，返回错误码
备注

要设置的枚举类型必须是Get接口返回的nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]中的一种，否则会失败

触发模式设置（软触发、硬触发）

◆ MV_CC_GetTriggerMode()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerMode	(	IN void *	handle,
		IN OUT MVCC_ENUMVALUE *	pstValue
	)

获取触发模式

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者的有关触发模式的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetPixelFormat() ，参考 CameraParams.h 中的 #MV_CAM_TRIGGER_MODE 定义

◆ MV_CC_SetTriggerMode()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerMode	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置触发模式

参数

handle[IN] 相机句柄 nValue[IN] 要设置的触发模式对应的整型值
返回

成功，返回MV_OK ,并且相机触发模式将会更改为相应值；失败，返回错误码

相机触发的延时

◆ MV_CC_GetTriggerDelay()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerDelay	(	IN void *	handle,
		IN OUT MVCC_FLOATVALUE *	pstValue
	)

获取触发延时

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机触发延时的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetFrameRate()

◆ MV_CC_SetTriggerDelay()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerDelay	(	IN void *	handle,
		IN const float	fValue
	)

设置触发延时

参数

handle[IN] 相机句柄 fValue[IN] 想要设置的相机触发延时
返回

成功，返回MV_OK ,并且相机触发延时将会更改为相应值；失败，返回错误码

触发源设置（可能跟硬触发有关）

◆ MV_CC_GetTriggerSource()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerSource	(	IN void *	handle,
		IN OUT MVCC_ENUMVALUE *	pstValue
	)

获取触发源

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者的有关触发源的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetPixelFormat() ，参考 CameraParams.h 中的 #MV_CAM_TRIGGER_SOURCE 定义

◆ MV_CC_SetTriggerSource()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerSource	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置触发源

参数

handle[IN] 相机句柄 nValue[IN] 要设置的触发源对应的整型值
返回

成功，返回MV_OK ,并且相机触发源将会更改为相应值；失败，返回错误码

软触发一次

◆ MV_CC_TriggerSoftwareExecute()

MV_CAMCTRL_API int __stdcall MV_CC_TriggerSoftwareExecute	(	IN void *	handle	)

软触发一次（接口仅在已选择的触发源为软件触发时有效）

参数

handle[IN] 相机句柄
返回

成功，返回MV_OK , 失败,返回错误码

Gamma类型设置

◆ MV_CC_GetGammaSelector()

MV_CAMCTRL_API int __stdcall MV_CC_GetGammaSelector	(	IN void *	handle,
		IN OUT MVCC_ENUMVALUE *	pstValue
	)

获取Gamma类型

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者的有关Gamma类型的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetPixelFormat() ，参考 CameraParams.h 中的 #MV_CAM_GAMMA_SELECTOR 定义

◆ MV_CC_SetGammaSelector()

MV_CAMCTRL_API int __stdcall MV_CC_SetGammaSelector	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置Gamma类型

参数

handle[IN] 相机句柄 nValue[IN] 要设置的Gamma类型对应的整型值
返回

成功，返回MV_OK ,并且相机Gamma类型将会更改为相应值；失败，返回错误码

Gamma值设置

◆ MV_CC_GetGamma()

MV_CAMCTRL_API int __stdcall MV_CC_GetGamma	(	IN void *	handle,
		IN OUT MVCC_FLOATVALUE *	pstValue
	)

获取Gamma值

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机Gamma值的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetExposureTime()

◆ MV_CC_SetGamma()

MV_CAMCTRL_API int __stdcall MV_CC_SetGamma	(	IN void *	handle,
		IN const float	fValue
	)

设置Gamma值

参数

handle[IN] 相机句柄 fValue[IN] 想要设置的相机Gamma值
返回

成功，返回MV_OK ,并且相机Gamma值将会更改为相应值；失败，返回错误码

灰度值设置

◆ MV_CC_GetHue()

MV_CAMCTRL_API int __stdcall MV_CC_GetHue	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取灰度

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机灰度结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetHue()

MV_CAMCTRL_API int __stdcall MV_CC_SetHue	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置灰度

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的灰度
返回

成功，返回MV_OK ,并且相机灰度将会更改为相应值；失败，返回错误码

饱和度设置

◆ MV_CC_GetSaturation()

MV_CAMCTRL_API int __stdcall MV_CC_GetSaturation	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取饱和度

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机饱和度结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetSaturation()

MV_CAMCTRL_API int __stdcall MV_CC_SetSaturation	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置饱和度

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的饱和度
返回

成功，返回MV_OK ,并且相机饱和度将会更改为相应值；失败，返回错误码

自动白平衡设置

◆ MV_CC_GetBalanceWhiteAuto()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceWhiteAuto	(	IN void *	handle,
		IN OUT MVCC_ENUMVALUE *	pstValue
	)

获取自动白平衡

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者的有关自动白平衡的信息结构体指针
返回

成功，返回MV_OK ,并获得相应参数信息的结构体；失败，返回错误码
备注

可参照接口 MV_CC_GetPixelFormat() ，参考 CameraParams.h 中的 #MV_CAM_BALANCEWHITE_AUTO 定义

◆ MV_CC_SetBalanceWhiteAuto()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceWhiteAuto	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置自动白平衡

参数

handle[IN] 相机句柄 nValue[IN] 要设置的自动白平衡对应的整型值
返回

成功，返回MV_OK ,并且相机自动白平衡将会更改为相应值；失败，返回错误码

白平衡红设置

◆ MV_CC_GetBalanceRatioRed()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioRed	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取白平衡红

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机白平衡红结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioRed()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioRed	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置白平衡红

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的白平衡红
返回

成功，返回MV_OK ,并且相机白平衡红将会更改为相应值；失败，返回错误码

白平衡绿设置

◆ MV_CC_GetBalanceRatioGreen()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioGreen	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取白平衡绿

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机白平衡绿结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioGreen()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioGreen	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置白平衡绿

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的白平衡绿
返回

成功，返回MV_OK ,并且相机白平衡绿将会更改为相应值；失败，返回错误码

白平衡蓝设置

◆ MV_CC_GetBalanceRatioBlue()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioBlue	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取白平衡蓝

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机白平衡蓝结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioBlue()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioBlue	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置白平衡蓝

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的白平衡蓝
返回

成功，返回MV_OK ,并且相机白平衡蓝将会更改为相应值；失败，返回错误码

心跳时间设置

◆ MV_CC_GetHeartBeatTimeout()

MV_CAMCTRL_API int __stdcall MV_CC_GetHeartBeatTimeout	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取心跳信息

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机心跳信息结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetHeartBeatTimeout()

MV_CAMCTRL_API int __stdcall MV_CC_SetHeartBeatTimeout	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置心跳信息

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的心跳信息
返回

成功，返回MV_OK ,并且相机心跳信息会更改为相应值；失败，返回错误码

网络包发送间隔设置

◆ MV_GIGE_GetGevSCPD()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCPD	(	IN void *	handle,
		IN OUT MVCC_INTVALUE *	pstValue
	)

获取网络包发送间隔

参数

handle[IN] 相机句柄 pstValue[IN][OUT] 返回给调用者有关相机网络包发送间隔结构体指针
返回

成功，返回MV_OK ；失败，返回错误码
备注

可参照接口 MV_CC_GetWidth()

◆ MV_GIGE_SetGevSCPD()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCPD	(	IN void *	handle,
		IN const unsigned int	nValue
	)

设置网络包发送间隔

参数

handle[IN] 相机句柄 nValue[IN] 想要设置的网络包发送间隔
返回

成功，返回MV_OK ,并且相机网络包发送间隔会更改为相应值；失败，返回错误码

接收端IP地址设置

◆ MV_GIGE_GetGevSCDA()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCDA	(	IN void *	handle,
		unsigned int *	pnIP
	)

获取接收端IP地址，0xa9fe0102 表示 169.254.1.2

参数

handle[IN] 相机句柄 pnIP[IN][OUT] 返回给调用者接收端IP地址
返回

成功，返回MV_OK ；失败，返回错误码

◆ MV_GIGE_SetGevSCDA()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCDA	(	IN void *	handle,
		unsigned int	nIP
	)

设置接收端IP地址

参数

handle[IN] 相机句柄 nIP[IN] 想要设置的接收端IP地址
返回

成功，返回MV_OK ,并且相机接收端IP地址会更改为相应值；失败，返回错误码

发送端的端口号地址

◆ MV_GIGE_GetGevSCSP()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCSP	(	IN void *	handle,
		unsigned int *	pnPort
	)

获取发送端的端口号

参数

handle[IN] 相机句柄 pnPort[IN][OUT] 返回给调用者发送端的端口号
返回

成功，返回MV_OK ；失败，返回错误码

◆ MV_GIGE_SetGevSCSP()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCSP	(	IN void *	handle,
		unsigned int	nPort
	)

设置发送端的端口号

参数

handle[IN] 相机句柄 nPort[IN] 想要设置的发送端的端口号
返回

成功，返回MV_OK ,并且相机发送端的端口号会更改为相应值；失败，返回错误码