Back to Adaptive Vision Library website

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

GenTL_OpenInterfaceModuleSettings


Header: Genicam.h
Namespace: avl
Module: Genicam

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.