GEV_STATUS GevOpenCameraBySN

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

Description

Creates a camera handle for accessing a camera identified by a camera’s serial number. The serial number is represented as a string that is programmed into the camera, by the manufacturer, to identify a particular camera unit.

Parameters

sn

A character string (16 characters max) that matches the serial number 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 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