Forward the tag values to all linked drivers.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_forward(
HISISDRV hSource,
HISISDRV hDestination
);
|
|
Arguments:
| hSource | The handle to the driver from which the tag values are being forwarded. Generally, this will be the current driver. |
| hDestination | 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.