Retrieve the current scanner driver name.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_set_scan_name( HWND hWnd, LPSTR lpszDriverName ); |
Arguments:
hWnd | The window handle for the parent window or the value zero (0). |
lpszDriverName | 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.