You are here: Start » Function Reference » GenTL » GenTL_OpenDeviceModuleSettings
GenTL_OpenDeviceModuleSettings
| Header: | Genicam.h |
|---|---|
| Namespace: | fil |
| Module: | Genicam |
Opens configuration node set of GenTL device (a device module configuration) of application side transport layer.
Syntax
GenTLHandle fil::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.
