Back to Adaptive Vision Library website
You are here: Start » Function Reference » GenTL » GenTL_OpenInterfaceModuleSettings
GenTL_OpenInterfaceModuleSettings
Opens configuration node set (an interface module configuration) of GenTL provider communication interface.
Syntax
C++
C#
GenTLHandle avl::GenTL_OpenInterfaceModuleSettings ( const atl::String& inLibraryPath, const atl::String& inInterfaceId )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inLibraryPath | const String& | Path identifying provider library. | ||
inInterfaceId | const String& | String identifying communication interface which should be accessed. |
Description
This function allows to access communication interface extended settings through GenAPI system. The function will open specified provider library interface module and return a handle to its instance. You can use GenApi functions to access module settings. These settings affect software-side transport layer of requested interface.
For every call to GenTL_OpenInterfaceModuleSettings a GenTL_CloseHandle function must be called on returned handle.
Exceptions
This function will throw an exception in the following situations:
- Invalid provider library path or interface id is specified.
- GenICam device description xml file of software module could not be loaded.
- Other general GenTL or GenICam error occurred.