GEV_STATUS GevFeatureValue

(GEV_CAMERA_HANDLE handle, const char *feature_name,
 int *feature_type, int value_size, void *value);

Description

Retrieves the value of a feature as well as its type.

This function is intended to be used from C code, where the GenApi object class accesses are not supported.

Note : The corresponding GenApi::CNodeMapRef object must already be associated with the camera handle via call to GevConnectFeatures.

Parameters

handle

Handle to the camera.

feature_name

String containing the name of the feature to be accessed.

feature_type

Pointer to storage to the feature type being returned. This is the integer version of the GenApi::EInterfacetype associated with the feature node accessed by name. The valid values are :

GENAPI_UNUSED_TYPE    = 1   for intfIBase/intfIValue/intfICategory that

                            are not accessible from C code.

GENAPI_INTEGER_TYPE   = 2   for GenApi::EInterfaceType intfIInteger  

GENAPI_BOOLEAN_TYPE   = 3   for GenApi::EInterfaceType intfIBoolean  

GENAPI_COMMAND_TYPE   = 4   for GenApi::EInterfaceType intfICommand  

GENAPI_FLOAT_TYPE     = 5   for GenApi::EInterfaceType intfIFloat    

GENAPI_STRING_TYPE    = 6   for GenApi::EInterfaceType intfIString   

GENAPI_REGISTER_TYPE  = 7   for GenApi::EInterfaceType intfRegister  

GENAPI_ENUM_TYPE      = 9   for GenApi::EInterfaceType intfIEnum      

GENAPI_ENUMENTRY_TYPE = 10  for GenApi::EInterfaceType intfIEnumEntry

value_size

Size, in bytes, of the storage pointed to by “value” that receives the data contained at the feature node being accessed.

value

Pointer to storage at which to return the data read from the feature node.

Return Value

GEVLIB_OK on success.