ImageGear for C and C++ on Windows v19.0
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.
|
Copy Code
|
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_forward(
HISISDRV hSource,
HISISDRV hDestination
);
|
|
| 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. |
Error count.
This function does not process image pixels.
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.