IG_ISIS_tag_flush

Release memory used by IG_ISIS_tag_save_value.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_tag_flush_value( HISISDRV hDriver, AT_MODE nTag );

Arguments:

hDriver	The handle to the driver.
nTag	Specifies the tag that was saved and whose memory needs to be flushed. Specify a value of zero if you specified zero in the corresponding IG_ISIS_tag_save_value function.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_tag_flush_value function releases the memory allocated by IG_ISIS_tag_save_value. Note that IG_ISIS_tag_restore_value automatically frees this memory.

Use IG_ISIS_tag_restore_value to free the memory used to store the value(s) saved when the application issued the most current IG_ISIS_tag_save_value call. Each call to IG_ISIS_tag_save_valuemust have a corresponding call to either IG_ISIS_tag_restore_value or IG_ISIS_tag_flush_value. This is a relatively new requirement, as multiple settings can now be saved in a stack. Previously, only one group of settings could be saved at a time, so only one call to IG_ISIS_tag_restore_valueor IG_ISIS_tag_flush_value was required.

The value of nTag should correspond to the value of nTag that was used when the corresponding IG_ISIS_tag_save_value was called. The values are saved in a last-in/first-out stack. By saving the settings of all tags multiple times, it is possible to implement a nested set of settings dialogs, one of which can be cancelled to restore original settings, even after accepting the settings in a previous one. (See IG_ISIS_tag_save_value.)

Example:

The following code fragment invokes IG_ISIS_tag_restore_value if the user chooses Cancel, or IG_ISIS_tag_flush_value if the user chooses OK:

	Copy Code
switch (GET_WM_COMMAND_ID(wParam, lParam)) { case IDCANCEL:IG_ISIS_tag_restore_value(DriverP,0); if (hModeList) {free(hModeList); hModeList = 0; } if (hWindowList) {free(hWindowList); hWindowList = 0; } EndDialog(hDlg,IG_ISIS_ERR_CANCEL); return TRUE; case IDOK:IG_ISIS_tag_flush_value(DriverP,0); if (hModeList) {free(hModeList); hModeList = 0; } if (hWindowList) {free(hWindowList); hWindowList = 0; }

Copy Code

switch (GET_WM_COMMAND_ID(wParam, lParam)) {
        case IDCANCEL:IG_ISIS_tag_restore_value(DriverP,0);
                if (hModeList) {free(hModeList);
                        hModeList = 0;
                }
                if (hWindowList) {free(hWindowList);
                        hWindowList = 0;
                }
                EndDialog(hDlg,IG_ISIS_ERR_CANCEL);
                return TRUE;
        case IDOK:IG_ISIS_tag_flush_value(DriverP,0);
                if (hModeList) {free(hModeList);
                        hModeList = 0;
                }
                if (hWindowList) {free(hWindowList);
                        hWindowList = 0;
                }