Back to Adaptive Vision Library website

You are here: Start » Function Reference » GenTL » GenTL_OpenDeviceModuleSettings

GenTL_OpenDeviceModuleSettings


Header:Genicam.h
Namespace:avl

Opens configuration node set of GenTL device (a device module configuration) of application side transport layer.

Syntax

C++
C#
 
GenTLHandle avl::GenTL_OpenDeviceModuleSettings
(
	GenTLHandle inDeviceHandle
)

Parameters

Name Type Default Description
inDeviceHandle GenTLHandle Handle of an opened device which application side module should be accessed.

Description

This function allows to access the connected device's software-side transport layer extended settings through GenAPI interface. The function takes a handle of the opened device (returned by GenTL_OpenDevice) and returns a new handle to its software module settings. You can use GenApi functions to access module settings.

For every call to GenTL_OpenDeviceModuleSettings GenTL_CloseHandle function must be called on returned handle. Device will be closed after all device and device module settings' handles have been closed.

Exceptions

This function will throw an exception in the following situations:

  • Device handle is invalid.
  • GenICam device description xml file of software module could not be loaded.
  • Other general GenTL or GenICam error occurred.