Back to Adaptive Vision Library website

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


Header: Genicam.h
Namespace: avl
Module: Genicam

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


GenTLHandle avl::GenTL_OpenDeviceModuleSettings
	GenTLHandle inDeviceHandle


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


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.


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.