ImageGear for C and C++ on Windows v19.1 - Updated
IG_ISIS_selection_build
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Custom Scanner Functions > IG_ISIS_selection_build

Create a list of drivers in the ISISSELECTION.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_selection_build(
        LPHISISSEL lphSelection,
        LPSTR lpszDriverName,
        DWORD dwDriverNameLen
);

Arguments:

Name Type Description
lphSelection LPHISISSEL The ISISSELECTION structure as initialized by IG_ISIS_selection_init.
lpszDriverName LPSTR Specifies a buffer for storing the name (including the full path) of the current driver.
dwDriverNameLen DWORD The size of the name buffer. It is recommended that you use a buffer of size _MAX_PATH from stdlib.h.

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_build function adds one driver to the ISISSELECTION structure each time it is called.

The IG_ISIS_selection_build function adds one driver to the ISISSELECTION at a time and should be called repeatedly until it returns a positive value. A return value of IGE_SUCCESS indicates more drivers still need to be added. It is recommended that your application display a progress monitor between each call to IG_ISIS_selection_build. The name of the current driver being added is available from DrvName.

See Also

IG_ISIS_selection_init