ImageGear for C and C++ on Windows v19.1 - Updated
IG_ISIS_drv_forward
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Driver Communication and Setup Functions > IG_ISIS_drv_forward

Forward the tag values to all linked drivers.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_forward(
        HISISDRV hSource,
        HISISDRV hDestination
);

Arguments:

Name Type Description
hSource HISISDRV The handle to the driver from which the tag values are being forwarded. Generally, this will be the current driver.
hDestination HISISDRV Always defined as zero.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_drv_forward function forwards the tag values from one driver to all linked drivers.

The IG_ISIS_drv_forward function normally is not called directly by an application program. It is called automatically by IG_ISIS_drv_run_step and IG_ISIS_drv_run_zone, so most developers can disregard this information.

The IG_ISIS_drv_forward function takes only one value (lpSource) and uses the value 0 instead of lpDestination. This causes the tag values from lpSource to be forwarded to all drivers linked by IG_ISIS_drv_link. If tag values must be forwarded only to a specific destination driver, then you must use the IG_ISIS_drv_send function to send IG_ISIS_drv_forward's message.

IG_ISIS_drv_forward works by making IG_ISIS_tag_set... calls on the destination driver(s) for each tag in the source driver.

See Also:

IG_ISIS_drv_run_step

IG_ISIS_drv_send

IG_ISIS_drv_run_zone