属性配置

获取和设置设备参数的万能接口 更多...

函数
MV_CAMCTRL_API int __stdcall	MV_CC_GetIntValueEx (IN void *handle, IN const char *strKey, IN OUT MVCC_INTVALUE_EX *pstIntValue)
	获取Integer属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetIntValueEx (IN void *handle, IN const char *strKey, IN int64_t nValue)
	设置Integer型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetEnumValue (IN void *handle, IN const char *strKey, IN OUT MVCC_ENUMVALUE *pstEnumValue)
	获取Enum属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetEnumValueEx (IN void *handle, IN const char *strKey, IN OUT MVCC_ENUMVALUE_EX *pstEnumValue)
	获取Enum属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetEnumValue (IN void *handle, IN const char *strKey, IN unsigned int nValue)
	设置Enum型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetEnumEntrySymbolic (IN void *handle, IN const char *strKey, IN OUT MVCC_ENUMENTRY *pstEnumEntry)
	获取Enum型节点指定值的符号 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetEnumValueByString (IN void *handle, IN const char *strKey, IN const char *strValue)
	设置Enum型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetFloatValue (IN void *handle, IN const char *strKey, IN OUT MVCC_FLOATVALUE *pstFloatValue)
	获取Float属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetFloatValue (IN void *handle, IN const char *strKey, IN float fValue)
	设置Float型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetBoolValue (IN void *handle, IN const char *strKey, IN OUT bool *pbValue)
	获取Boolean属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetBoolValue (IN void *handle, IN const char *strKey, IN bool bValue)
	设置Boolean型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_GetStringValue (IN void *handle, IN const char *strKey, IN OUT MVCC_STRINGVALUE *pstStringValue)
	获取String属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetStringValue (IN void *handle, IN const char *strKey, IN const char *strValue)
	设置String型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetCommandValue (IN void *handle, IN const char *strKey)
	设置Command型属性值 更多...
MV_CAMCTRL_API int __stdcall	MV_XML_GetNodeAccessMode (IN void *handle, IN const char *strName, IN OUT enum MV_XML_AccessMode *penAccessMode)
	获得当前节点的访问模式 更多...
MV_CAMCTRL_API int __stdcall	MV_XML_GetNodeInterfaceType (IN void *handle, IN const char *strName, IN OUT enum MV_XML_InterfaceType *penInterfaceType)
	获得当前节点的类型 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FeatureLoad (IN void *handle, IN const char *strFileName)
	导入设备属性 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FeatureLoadEx (IN void *handle, IN const char *strFileName, IN OUT MVCC_NODE_ERROR_LIST *pstNodeErrorList)
	导入设备属性并保存错误信息列表 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FeatureSave (IN void *handle, IN const char *strFileName)
	保存设备属性 更多...

详细描述

获取和设置设备参数的万能接口

函数说明

MV_CC_GetIntValueEx()

MV_CAMCTRL_API int __stdcall MV_CC_GetIntValueEx	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_INTVALUE_EX *	pstIntValue
	)

获取Integer属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取宽度信息则为"Width"
pstIntValue	[IN][OUT] 返回给调用者有关设备属性结构体指针

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取int类型的指定节点的值。具体可查看客户端的属性描述。

示例

Grab_Asynchronous.cpp, HighBandwidthDecode.cpp, InterfaceDemo.cpp , 以及 MultiLightCtrl_ImageStitching.cpp.

MV_CC_SetIntValueEx()

MV_CAMCTRL_API int __stdcall MV_CC_SetIntValueEx	(	IN void *	handle,
		IN const char *	strKey,
		IN int64_t	nValue
	)

设置Integer型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取宽度信息则为"Width"
nValue	[IN] 想要设置的设备的属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置int类型的指定节点的值，具体可以查看客户端属性描述。

示例

ChunkData.cpp, ConnectSpecCamera.cpp, Display.cpp, Events.cpp, Grab_Asynchronous.cpp, GrabImage.cpp, GrabImage_Callback.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, HighBandwidthDecode.cpp, ImageProcess.cpp, InterfaceAndDeviceDemo.cpp, InterfaceDemo.cpp, LineScanSoftwareTrigger.cpp, MultiCast.cpp, ParametrizeCamera_AreaScanIOSettings.cpp, ParametrizeCamera_LineScanIOSettings.cpp, ReconnectDemo.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

MV_CC_GetEnumValue()

MV_CAMCTRL_API int __stdcall MV_CC_GetEnumValue	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_ENUMVALUE *	pstEnumValue
	)

获取Enum属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取像素格式信息则为"PixelFormat"
pstEnumValue	[IN][OUT] 返回给调用者有关设备属性结构体指针

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取Enum类型的指定节点的值。

示例

InterfaceDemo.cpp , 以及 SetParam.cpp.

MV_CC_GetEnumValueEx()

MV_CAMCTRL_API int __stdcall MV_CC_GetEnumValueEx	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_ENUMVALUE_EX *	pstEnumValue
	)

获取Enum属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取像素格式信息则为"PixelFormat"
pstEnumValue	[IN][OUT] 返回给调用者有关设备属性结构体指针

返回

成功，返回MV_OK；失败，返回状态码。

备注

• 连接设备之后调用该接口可以获取Enum类型的指定节点的值。
  
• 区别与 MV_CC_GetEnumValue() ，此接口返回的枚举有效个数扩展到256个。

MV_CC_SetEnumValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetEnumValue	(	IN void *	handle,
		IN const char *	strKey,
		IN unsigned int	nValue
	)

设置Enum型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取像素格式信息则为"PixelFormat"
nValue	[IN] 想要设置的设备的属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置Enum类型的指定节点的值。

示例

ChunkData.cpp, ConnectSpecCamera.cpp, Events.cpp, Grab_Asynchronous.cpp, GrabImage.cpp, GrabImage_Callback.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, HighBandwidthDecode.cpp, ImageProcess.cpp, ImageSave.cpp, InterfaceAndDeviceDemo.cpp, InterfaceDemo.cpp, LineScanSoftwareTrigger.cpp, MultiLightCtrl_ImageStitching.cpp, ParametrizeCamera_LineScanIOSettings.cpp, QuickSoftwareTrigger.cpp, ReconnectDemo.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

MV_CC_GetEnumEntrySymbolic()

MV_CAMCTRL_API int __stdcall MV_CC_GetEnumEntrySymbolic	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_ENUMENTRY *	pstEnumEntry
	)

获取Enum型节点指定值的符号

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取像素格式信息则为"PixelFormat"
pstEnumEntry	[IN][OUT] 想要获取的设备的属性符号

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取Enum类型的指定节点的值所对应的符号。

示例

InterfaceDemo.cpp.

MV_CC_SetEnumValueByString()

MV_CAMCTRL_API int __stdcall MV_CC_SetEnumValueByString	(	IN void *	handle,
		IN const char *	strKey,
		IN const char *	strValue
	)

设置Enum型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值，如获取像素格式信息则为"PixelFormat"
strValue	[IN] 想要设置的设备的属性字符串

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置Enum类型的指定节点的值。

示例

ChunkData.cpp, LineScanSoftwareTrigger.cpp, ParametrizeCamera_AreaScanIOSettings.cpp, ParametrizeCamera_FileAccess.cpp, ParametrizeCamera_LineScanIOSettings.cpp , 以及 QuickSoftwareTrigger.cpp.

MV_CC_GetFloatValue()

MV_CAMCTRL_API int __stdcall MV_CC_GetFloatValue	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_FLOATVALUE *	pstFloatValue
	)

获取Float属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
pstFloatValue	[IN][OUT] 返回给调用者有关设备属性结构体指针

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取float类型的指定节点的值。

示例

InterfaceDemo.cpp , 以及 SetParam.cpp.

MV_CC_SetFloatValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetFloatValue	(	IN void *	handle,
		IN const char *	strKey,
		IN float	fValue
	)

设置Float型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
fValue	[IN] 想要设置的设备的属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置float类型的指定节点的值。

示例

InterfaceDemo.cpp, ParametrizeCamera_AreaScanIOSettings.cpp , 以及 SetParam.cpp.

MV_CC_GetBoolValue()

MV_CAMCTRL_API int __stdcall MV_CC_GetBoolValue	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT bool *	pbValue
	)

获取Boolean属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
pbValue	[IN][OUT] 返回给调用者有关设备属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取bool类型的指定节点的值。

示例

InterfaceDemo.cpp , 以及 SetParam.cpp.

MV_CC_SetBoolValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetBoolValue	(	IN void *	handle,
		IN const char *	strKey,
		IN bool	bValue
	)

设置Boolean型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
bValue	[IN] 想要设置的设备的属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置bool类型的指定节点的值。

示例

ChunkData.cpp, Grab_Asynchronous.cpp, InterfaceDemo.cpp, LineScanSoftwareTrigger.cpp, ParametrizeCamera_AreaScanIOSettings.cpp, ParametrizeCamera_LineScanIOSettings.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

MV_CC_GetStringValue()

MV_CAMCTRL_API int __stdcall MV_CC_GetStringValue	(	IN void *	handle,
		IN const char *	strKey,
		IN OUT MVCC_STRINGVALUE *	pstStringValue
	)

获取String属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
pstStringValue	[IN][OUT] 返回给调用者有关设备属性结构体指针

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以获取string类型的指定节点的值。

示例

GrabMultipleCamera.cpp, InterfaceDemo.cpp , 以及 SetParam.cpp.

MV_CC_SetStringValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetStringValue	(	IN void *	handle,
		IN const char *	strKey,
		IN const char *	strValue
	)

设置String型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值
strValue	[IN] 想要设置的设备的属性值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置string类型的指定节点的值。

示例

InterfaceDemo.cpp , 以及 SetParam.cpp.

MV_CC_SetCommandValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetCommandValue	(	IN void *	handle,
		IN const char *	strKey
	)

设置Command型属性值

参数

handle	[IN] 设备句柄/采集卡句柄
strKey	[IN] 属性键值

返回

成功，返回MV_OK；失败，返回状态码。

备注

连接设备之后调用该接口可以设置指定的Command类型节点。

示例

LineScanSoftwareTrigger.cpp, ParametrizeCamera_FileAccess.cpp, QuickSoftwareTrigger.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

MV_XML_GetNodeAccessMode()

MV_CAMCTRL_API int __stdcall MV_XML_GetNodeAccessMode	(	IN void *	handle,
		IN const char *	strName,
		IN OUT enum MV_XML_AccessMode *	penAccessMode
	)

获得当前节点的访问模式

参数

handle	[IN] 设备句柄/采集卡句柄
strName	[IN] 节点名称
penAccessMode	[IN][OUT] 节点的访问模式

返回

成功，返回MV_OK；失败，返回状态码。

示例

InterfaceDemo.cpp, LineScanSoftwareTrigger.cpp , 以及 ParametrizeCamera_LineScanIOSettings.cpp.

MV_XML_GetNodeInterfaceType()

MV_CAMCTRL_API int __stdcall MV_XML_GetNodeInterfaceType	(	IN void *	handle,
		IN const char *	strName,
		IN OUT enum MV_XML_InterfaceType *	penInterfaceType
	)

获得当前节点的类型

参数

handle	[IN] 设备句柄/采集卡句柄
strName	[IN] 节点名称
penInterfaceType	[IN][OUT] 节点的类型

返回

成功，返回MV_OK；失败，返回状态码。

备注

在调用 MV_CC_GetIntValueEx() 、 MV_CC_SetIntValueEx() 等万能接口之前，您可调用该接口获取节点类型，方便选择合适的接口进行节点值的设置和获取。

MV_CC_FeatureLoad()

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

导入设备属性

参数

handle	[IN] 设备句柄/采集卡句柄
strFileName	[IN] 属性文件名

返回

成功，返回MV_OK；失败，返回状态码。

示例

ParametrizeCamera_LoadAndSave.cpp.

MV_CC_FeatureLoadEx()

MV_CAMCTRL_API int __stdcall MV_CC_FeatureLoadEx	(	IN void *	handle,
		IN const char *	strFileName,
		IN OUT MVCC_NODE_ERROR_LIST *	pstNodeErrorList
	)

导入设备属性并保存错误信息列表

参数

handle	[IN] 设备句柄/采集卡句柄
strFileName	[IN] 属性文件名
pstNodeErrorList	[IN OUT] 错误信息列表

返回

成功，返回MV_OK；失败，返回状态码。

备注

• 部分节点导入失败时，接口返回MV_OK，通过错误信息列表中stNodeError获取出错节点及失败原因
• pstNodeErrorList该参数在外部申请并由内部填充数据。该参数可接受填入null，代表用户不关心导入时的错误信息。

MV_CC_FeatureSave()

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

保存设备属性

参数

handle	[IN] 设备句柄/采集卡句柄
strFileName	[IN] 属性文件名

返回

成功，返回MV_OK；失败，返回状态码。

示例

ParametrizeCamera_LoadAndSave.cpp.