GEV_STATUS GevOpenCameraByName

(char *name, GevAccessMode mode,
 GEV_CAMERA_HANDLE *handle);

Description

Creates a camera handle for accessing a camera identified by a camera’s user defined name. The user defined name is a string that can be programmed into the camera for use in identifying multiple cameras.

Parameters

name

A character string (16 characters max) that will be used to match the user defined name string contained in a camera connected on the system.

mode

The required access mode. The available values are:

GevExclusiveMode        : Exclusive R/W access to the camera.
GevMonitorMode          : Shared Read-only access to the camera.
GevControlMode                  : Shared R/W access to the camera.

The most commonly used mode for user imaging applications is GevExclusiveMode.

handle

Pointer to a GEV_CAMERA_HANDLE type
to receive the allocated handle to be used to access the camera.

Return Value

GEV_STATUS

Possible values are:

GEVLIB_ERROR_API_NOT_INITIALIZED
GEVLIB_ERROR_INVALID_HANDLE
GEVLIB_ERROR_INSUFFICIENT_MEMORY
GEVLIB_ERROR_NO_CAMERA
GEV_STATUS_ACCESS_DENIED