ImageGear for C and C++ on Windows v19.3 - Updated
IG_ISIS_drv_start_zone
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Single-Step Driver Control Functions > IG_ISIS_drv_start_zone

Start a new zone.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_start_zone(
        HISISDRV hPage,
        LPHISISDRV lphZone
);

Arguments:

Name Type Description
hPage HISISDRV The handle of the page in which this zone is being created.
lphZone LPHISISDRV A pointer to the handle of the zone created and returned by the IG_ISIS_drv_start_zone function.

Return Value:

Error count.

Supported Raster Image Formats:

Depends on the scanner driver.

Example:

See IG_ISIS_drv_start_data example.

Remarks:

The IG_ISIS_drv_start_zone function tells a driver to start a new zone and returns a zone handle.

IG_ISIS_drv_start_zone is one of several hierarchical data transfer functions that are called automatically by the IG_ISIS_drv_run_zone function. The hierarchy of data transfer functions is:

 
Copy Code
IG_ISIS_drv_start_stack
     IG_ISIS_drv_start_page
          IG_ISIS_drv_start_zone
               IG_ISIS_drv_forward
                    IG_ISIS_drv_start_data
                         IG_ISIS_drv_put_data
          IG_ISIS_drv_end_zone
     IG_ISIS_drv_end_page
IG_ISIS_drv_end_stack

Most scanners do not support the concept of multiple zones, and will therefore ignore this message.