ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ISIS Component API Reference / ISIS Component Functions Reference / Custom Scanner Functions / IG_ISIS_selection_init
In This Topic
    IG_ISIS_selection_init
    In This Topic

    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