ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ISIS Component API Reference / ISIS Component Functions Reference / Single-Step Driver Control Functions / IG_ISIS_drv_start_zone
In This Topic
    IG_ISIS_drv_start_zone
    In This Topic

    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.