ImageGear for C and C++ on Windows v19.3 - Updated
IG_ISIS_drv_get_scan_name
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Driver Communication and Setup Functions > IG_ISIS_drv_get_scan_name

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