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.