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_configure
In This Topic
    IG_ISIS_selection_configure
    In This Topic

    Configure a scanner/driver combination given a scanner information record.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_ISIS_selection_configure(
            LPHISISSEL lphSelection,
            LPAT_ISIS_DRIVERINFO lpDriverInfo,
            HWND hWndParent,
            AT_BOOL bOnlyIfNecessary
    );
    

    Arguments:

    Name Type Description
    lphSelection LPHISISSEL Points to the ISISSELECTION structure as initialized by IG_ISIS_selection_init.
    lpDriverInfo LPAT_ISIS_DRIVERINFO Points to a scanner information record obtained by calling IG_ISIS_selection_get_driver_info.
    hWndParent HWND Handle to the parent window (provided for handling dialogs that may pop up).
    bOnlyIfNecessary AT_BOOL If this value is set to TRUE, then IG_ISIS_drv_configure will only be called if the specified scanner/driver combination has not yet been set up. Otherwise, IG_ISIS_drv_configure will always be called even if no further configuration is necessary.

    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_configure function loads the driver from the specified scanner information record, calls IG_ISIS_drv_configure on it to display the driver configuration dialog, then unloads the driver.

    Use the IG_ISIS_selection_configure function to perform any necessary driver setup and configuration once the user has selected a scanner.

    See Also

    IG_ISIS_selection_get_driver_info

    IG_ISIS_drv_configure