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

Initialize a ISISSELECTION structure.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_selection_init(
        LPHISISSEL lphSelection,
        AT_MODE nSelectionType,
        LPSTR lpszDirectory
);

Arguments:

Name Type Description
lphSelection LPHISISSEL The ISISSELECTION structure to be initialized.
nSelectionType AT_MODE Specifies the type of desired ISISSELECTION structure. Set nSelectionType to ISISSELECTION_MAINLIST if you are accessing drivers from the standard driver directories (<WINDIR> and <WINDIR>\PIXTRAN). Set nSelectionType to ISISSELECTION_ADDLIST if you are adding drivers from a supplemental directory specified by Directory.
lpszDirectory LPSTR Specifies the path to the supplemental driver directory if nSelectionType is set to ISISSELECTION_ADDLIST. Otherwise NULL.

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_init function initializes a ISISSELECTION structure for use by other IG_ISIS_selection... functions and counts the number of drivers in the specified directory.

You must initialize a new ISISSELECTION structure for each set of drivers before using any other IG_ISIS_selection... function. Once your ISISSELECTION structure has been initialized, call IG_ISIS_selection_build to populate the structure with an internal list of drivers found in the specified directory.

See Also

IG_ISIS_selection_build

IG_ISIS_selection_done