通用接口

包含SDK图像缓存节点设置、事件注册和相机属性导入导出等接口。 更多...

函数
MV_CAMCTRL_API bool __stdcall	MV_CC_IsDeviceConnected (IN void *handle)
	判断设备是否处于连接状态 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetImageNodeNum (IN void *handle, unsigned int nNum)
	设置SDK内部图像缓存节点个数，大于等于1，在抓图前调用 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetImageInfo (IN void *handle, IN OUT MV_IMAGE_BASIC_INFO *pstInfo)
	获取图像基本信息 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetAllMatchInfo (IN void *handle, IN OUT MV_ALL_MATCH_INFO *pstInfo)
	获取各种类型的信息 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_InvalidateNodes (IN void *handle)
	清除GenICam节点缓存 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_RegisterExceptionCallBack (IN void *handle, void(__stdcall *cbException)(unsigned int nMsgType, void *pUser), void *pUser)
	注册异常消息回调，在打开设备之后调用 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_RegisterAllEventCallBack (void *handle, void(__stdcall *cbEvent)(MV_EVENT_OUT_INFO *pEventInfo, void *pUser), void *pUser)
	注册全部事件回调，在打开设备之后调用 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_RegisterEventCallBackEx (void *handle, const char *strEventName, void(__stdcall *cbEvent)(MV_EVENT_OUT_INFO *pEventInfo, void *pUser), void *pUser)
	注册单个事件回调，在打开设备之后调用 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FeatureSave (IN void *handle, IN const char *pFileName)
	保存相机属性 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FeatureLoad (IN void *handle, IN const char *pFileName)
	导入相机属性 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FileAccessRead (IN void *handle, IN MV_CC_FILE_ACCESS *pstFileAccess)
	从相机读取文件 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FileAccessWrite (IN void *handle, IN MV_CC_FILE_ACCESS *pstFileAccess)
	将文件写入相机 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetFileAccessProgress (IN void *handle, OUT MV_CC_FILE_ACCESS_PROGRESS *pstFileAccessProgress)
	获取文件存取的进度 更多...

详细描述

包含SDK图像缓存节点设置、事件注册和相机属性导入导出等接口。

函数说明

MV_CC_IsDeviceConnected()

MV_CAMCTRL_API bool __stdcall MV_CC_IsDeviceConnected

(

IN void *

handle

)

判断设备是否处于连接状态

参数

handle

[IN] 设备句柄

返回

设备处于连接状态，返回true；没连接或失去连接，返回false

MV_CC_SetImageNodeNum()

MV_CAMCTRL_API int __stdcall MV_CC_SetImageNodeNum	(	IN void *	handle,
		unsigned int	nNum
	)

设置SDK内部图像缓存节点个数，大于等于1，在抓图前调用

参数

handle	[IN] 设备句柄
nNum	[IN] 缓存节点个数

返回

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

备注

 • 调用该接口可以设置SDK内部图像缓存节点个数，在调用 MV_CC_StartGrabbing() 开始抓图前调用。
 • 在SDK中默认是1个节点。

MV_CC_GetImageInfo()

MV_CAMCTRL_API int __stdcall MV_CC_GetImageInfo	(	IN void *	handle,
		IN OUT MV_IMAGE_BASIC_INFO *	pstInfo
	)

获取图像基本信息

参数

handle	[IN] 相机句柄
pstInfo	[IN][OUT] 返回给调用者有关相机图像基本信息结构体指针

返回

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

MV_CC_GetAllMatchInfo()

MV_CAMCTRL_API int __stdcall MV_CC_GetAllMatchInfo	(	IN void *	handle,
		IN OUT MV_ALL_MATCH_INFO *	pstInfo
	)

获取各种类型的信息

参数

handle	[IN] 设备句柄
pstInfo	[IN][OUT] 返回给调用者有关设备各种类型的信息结构体指针

返回

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

备注

 • 接口里面输入需要获取的信息类型（指定 MV_ALL_MATCH_INFO 结构体中的nType类型），获取对应的信息（在 MV_ALL_MATCH_INFO 结构体中pInfo里返回）。
 • 该接口的调用前置条件取决于所获取的信息类型，获取GigE设备的 MV_MATCH_TYPE_NET_DETECT 信息需在开启抓图之后调用，获取U3V设备的 MV_MATCH_TYPE_USB_DETECT 信息需在打开设备之后调用。

MV_CC_InvalidateNodes()

MV_CAMCTRL_API int __stdcall MV_CC_InvalidateNodes

(

IN void *

handle

)

清除GenICam节点缓存

参数

handle

[IN] 设备句柄

返回

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

MV_CC_RegisterExceptionCallBack()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterExceptionCallBack	(	IN void *	handle,
		void(__stdcall *cbException)(unsigned int nMsgType, void *pUser)	,
		void *	pUser
	)

注册异常消息回调，在打开设备之后调用

参数

handle	[IN] 设备句柄
cbException	[IN] 异常回调函数指针
pUser	[IN] 用户自定义变量

返回

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

备注

 • 该接口需要在 MV_CC_OpenDevice() 打开设备之后调用。设备异常断开连接后可以在回调里面获取到异常消息，GigE设备掉线之后需要先调用 MV_CC_CloseDevice() 接口关闭设备，再调用 MV_CC_OpenDevice() 接口重新打开设备。

宏定义	宏定义值	含义
MV_GIGE_EXCEPTION_DEV_DISCONNECT	0x00008001	设备断开连接

示例

ReconnectDemo.cpp.

MV_CC_RegisterAllEventCallBack()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterAllEventCallBack	(	void *	handle,
		void(__stdcall *cbEvent)(MV_EVENT_OUT_INFO *pEventInfo, void *pUser)	,
		void *	pUser
	)

注册全部事件回调，在打开设备之后调用

参数

handle	[IN] 设备句柄
cbEvent	[IN] 事件回调函数指针
pUser	[IN] 用户自定义变量

返回

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

备注

 • 通过该接口设置事件回调，可以在回调函数里面获取采集、曝光等事件信息。

MV_CC_RegisterEventCallBackEx()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterEventCallBackEx	(	void *	handle,
		const char *	strEventName,
		void(__stdcall *cbEvent)(MV_EVENT_OUT_INFO *pEventInfo, void *pUser)	,
		void *	pUser
	)

注册单个事件回调，在打开设备之后调用

参数

handle	[IN] 设备句柄
strEventName	[IN] 事件名称
cbEvent	[IN] 事件回调函数指针
pUser	[IN] 用户自定义变量

返回

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

备注

 • 通过该接口设置事件回调，可以在回调函数里面获取采集、曝光等事件信息。
 • 该接口不支持CameraLink设备，仅支持"设备掉线"这一种事件。

示例

Events.cpp.

MV_CC_FeatureSave()

MV_CAMCTRL_API int __stdcall MV_CC_FeatureSave	(	IN void *	handle,
		IN const char *	pFileName
	)

保存相机属性

参数

handle	[IN] 设备句柄
pFileName	[IN] 属性文件名

返回

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

示例

ParametrizeCamera_LoadAndSave.cpp.

MV_CC_FeatureLoad()

MV_CAMCTRL_API int __stdcall MV_CC_FeatureLoad	(	IN void *	handle,
		IN const char *	pFileName
	)

导入相机属性

参数

handle	[IN] 设备句柄
pFileName	[IN] 属性文件名

返回

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

示例

ParametrizeCamera_LoadAndSave.cpp.

MV_CC_FileAccessRead()

MV_CAMCTRL_API int __stdcall MV_CC_FileAccessRead	(	IN void *	handle,
		IN MV_CC_FILE_ACCESS *	pstFileAccess
	)

从相机读取文件

参数

handle	[IN] 设备句柄
pstFileAccess	[IN] 文件存取结构体

返回

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

示例

ParametrizeCamera_FileAccess.cpp.

MV_CC_FileAccessWrite()

MV_CAMCTRL_API int __stdcall MV_CC_FileAccessWrite	(	IN void *	handle,
		IN MV_CC_FILE_ACCESS *	pstFileAccess
	)

将文件写入相机

参数

handle	[IN] 设备句柄
pstFileAccess	[IN] 文件存取结构体

返回

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

示例

ParametrizeCamera_FileAccess.cpp.

MV_CC_GetFileAccessProgress()

MV_CAMCTRL_API int __stdcall MV_CC_GetFileAccessProgress	(	IN void *	handle,
		OUT MV_CC_FILE_ACCESS_PROGRESS *	pstFileAccessProgress
	)

获取文件存取的进度

参数

handle	[IN] 设备句柄
pstFileAccessProgress	[IN] 进度内容

返回

成功，返回MV_OK ；失败，返回错误码 （当前文件存取的状态）

示例

ParametrizeCamera_FileAccess.cpp.