ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ISIS Component API Reference / ISIS Component Functions Reference / Driver Communication and Setup Functions / IG_ISIS_drv_get_scan_name
In This Topic
    IG_ISIS_drv_get_scan_name
    In This Topic

    Retrieve the current scanner driver name.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_ISIS_drv_set_scan_name(
            HWND hWnd,
            LPSTR lpszDriverName
    );
    

    Arguments:

    Name Type Description
    hWnd HWND The window handle for the parent window or the value zero (0).
    lpszDriverName LPSTR A pointer to the buffer that will contain the current driver name (filename root only, e.g., "FUJIGINE") after executing IG_ISIS_drv_set_scan_name.

    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_drv_set_scan_namefunction retrieves the current driver name.

    IG_ISIS_drv_set_scan_name retrieves and fills in the currently selected scanner driver by reading the "Driver?=" entry of the [Scanner] section in the SETSCAN.INI file. If no name is set and hWnd is not zero (0), then the toolkit attempts to get a scanner by calling IG_ISIS_drv_set_scan_name and displaying the Select Scanner dialog box.

    Developers need to unload scanner drivers before calling IG_ISIS_drv_set_scan_name. A new scanner driver cannot be loaded while the existing scanner driver is still loaded. This means that the application may have to unload a scanner driver, then reload the driver and initialize it if the user chooses the same scanner or hits the Cancel button.

    See Also:

    IG_ISIS_drv_set_scan_name

    IG_ISIS_drv_get_model_name