Initialize a ISISSELECTION structure.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ACCUAPI IG_ISIS_selection_init(
LPHISISSEL lphSelection,
AT_MODE nSelectionType,
LPSTR lpszDirectory
);
|
Arguments:
Name |
Type |
Description |
lphSelection |
LPHISISSEL |
The ISISSELECTION structure to be initialized. |
nSelectionType |
AT_MODE |
Specifies the type of desired ISISSELECTION structure. Set nSelectionType to ISISSELECTION_MAINLIST if you are accessing drivers from the standard driver directories (<WINDIR> and <WINDIR>\PIXTRAN). Set nSelectionType to ISISSELECTION_ADDLIST if you are adding drivers from a supplemental directory specified by Directory. |
lpszDirectory |
LPSTR |
Specifies the path to the supplemental driver directory if nSelectionType is set to ISISSELECTION_ADDLIST. Otherwise NULL. |
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_init function initializes a ISISSELECTION structure for use by other IG_ISIS_selection... functions and counts the number of drivers in the specified directory.
You must initialize a new ISISSELECTION structure for each set of drivers before using any other IG_ISIS_selection... function. Once your ISISSELECTION structure has been initialized, call IG_ISIS_selection_build to populate the structure with an internal list of drivers found in the specified directory.
See Also
IG_ISIS_selection_build
IG_ISIS_selection_done