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_build
In This Topic
    IG_ISIS_selection_build
    In This Topic

    Create a list of drivers in the ISISSELECTION.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_ISIS_selection_build(
            LPHISISSEL lphSelection,
            LPSTR lpszDriverName,
            DWORD dwDriverNameLen
    );
    

    Arguments:

    Name Type Description
    lphSelection LPHISISSEL The ISISSELECTION structure as initialized by IG_ISIS_selection_init.
    lpszDriverName LPSTR Specifies a buffer for storing the name (including the full path) of the current driver.
    dwDriverNameLen DWORD The size of the name buffer. It is recommended that you use a buffer of size _MAX_PATH from stdlib.h.

    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_build function adds one driver to the ISISSELECTION structure each time it is called.

    The IG_ISIS_selection_build function adds one driver to the ISISSELECTION at a time and should be called repeatedly until it returns a positive value. A return value of IGE_SUCCESS indicates more drivers still need to be added. It is recommended that your application display a progress monitor between each call to IG_ISIS_selection_build. The name of the current driver being added is available from DrvName.

    See Also

    IG_ISIS_selection_init