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

Start a new stack.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_start_stack(
        HISISDRV hDriver,
        LPHISISDRV lphStack);

Arguments:

Name Type Description
hDriver HISISDRV The handle of the driver in which this stack is being created.
lphStack LPHISISDRV A pointer to the handle of the stack created and returned by the IG_ISIS_drv_start_stack 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_stack function tells a driver to start a new stack and returns a stack handle.

IG_ISIS_drv_start_stack is the top 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  

A number of scanners do not support the concept of multiple stacks, and will therefore ignore the message sent by this function.