GEV_STATUS GevReadRegisterByName

(GEV_CAMERA_HANDLE handle, char *name, int selector,
 UINT32 size, void *data);

Description

Reads a camera register, identified by name. A helper function using the pattern GevGetRegisterPtrByName and GevRegisterRead.

Parameters

handle

GEV_CAMERA_HANDLE identifying the camera.

name

Name to use to search for a GEV_REGISTER structure for the camera.

selector

Index into a group of registers providing the same functionality. These register groups need to be set up properly in the GEV_REGISTER structure.

This is generally 0 as the ‘array’ based functions can be used to access multiple contiguous locations.

size

Size of the data to be read.

*data

Pointer to a location, allocated by the caller, to receive the data to be read.

Return Value

GEV_STATUS STATUS

Possible values are:

GEVLIB_OK
GEVLIB_ERROR_INVALID_HANDLE
GEVLIB_ERROR_RESOURCE_NOT_ENABLED
                                     (GEV_REGISTER struct is for a register that is not available)
GEVLIB_ERROR_NOT_IMPLEMENTED (GEV_REGISTER struct is for a Write-Only register)
GEVLIB_ERROR_SOFTWARE (GEV_REGISTER struct defines an unsupported register type)