Initialize the driver iteration cycle to obtain scanner information from a ISISSELECTION structure.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_selection_iterate_init(
LPHISISSEL lphSelection,
LPHISISSELITER lphIteration,
LPAT_ISIS_DRIVERINFO lpDriverInfo
);
|
|
Arguments:
| Name | Type | Description |
| lphSelection | LPHISISSEL | Points to the ISISSELECTION structure as initialized by IG_ISIS_selection_init. |
| lphIteration | LPHISISSELITER | Specifies the driver iteration cycle to initialize. |
| lpDriverInfo | LPAT_ISIS_DRIVERINFO | Points to the first scanner information record obtained from the iteration cycle. |
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_iterate_init function starts the iteration cycle and fills in the first scanner information record.
The IG_ISIS_selection_iterate_init and IG_ISIS_selection_iterate_next functions go through the drivers in the mySelection list to obtain information on all scanner models supported by those drivers. Each AT_ISIS_DRIVERINFO structure returned in driverInfo contains the model name of the scanner, its associated driver, and a unique ID. Your application can then present a list of all the supported scanner models to the user. If you keep track of the association between the scanner name and its ID, you can then use the IG_ISIS_selection_get_driver_info function to retrieve the scanner information record after the user selects a scanner.
You should call IG_ISIS_selection_iterate_next repeatedly until all the records have been found. Then call IG_ISIS_selection_iterate_done to release the memory allocated for the iteration cycle.
See Also
IG_ISIS_selection_iterate_next
IG_ISIS_selection_iterate_done
IG_ISIS_selection_get_driver_info