ImageGear for C and C++ on Windows v19.4 - Updated
IG_ISIS_selection_add_scanner
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Custom Scanner Functions > IG_ISIS_selection_add_scanner

Copy a driver file from a supplemental location and add it to the list in the ISISSELECTION structure.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_selection_add_scanner(
        LPHISISSEL lphSelectionDestination,
        LPAT_ISIS_DRIVERINFO lpDriverInfo,
        AT_BOOL bForceInstall
);

Arguments:

Name Type Description
lphSelectionDestination LPHISISSEL The ISISSELECTION structure as initialized by IG_ISIS_selection_init. The ISISSELECTION must have been initialized with its iSelectionType set to ISISSELECTION_MAINLIST.
lpDriverInfo LPAT_ISIS_DRIVERINFO Points to a scanner information record obtained by calling IG_ISIS_selection_get_driver_info.
bForceInstall AT_BOOL If this value is set to FALSE, then the driver file will only be copied if it is newer than the existing driver in the standard directory or if there is no existing driver. Otherwise, the driver file will be copied even if it will overwrite a newer version.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_selection_add_scanner function copies the driver file specified in driverInfo into the standard system directory and add the driver to the ISISSELECTION.

Use IG_ISIS_selection_add_scanner to install a scanner driver from a non-system directory. First, create a source ISISSELECTION structure by calling IG_ISIS_selection_init with the path to the supplemental directory and with iSelectionType set to IG_ISIS_SELECTION_ADDLIST. Then use IG_ISIS_selection_get_driver_info to retrieve the selected scanner information record from the source ISISSELECTION and pass it to IG_ISIS_selection_add_scanner.

See Also

IG_ISIS_selection_init

IG_ISIS_selection_get_driver_info