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_stack
In This Topic
    IG_ISIS_drv_start_stack
    In This Topic

    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.