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.