Get the current value of an ASCII tag.
Copy Code
|
|
---|---|
AT_ERRCOUNT ACCUAPI IG_ISIS_tag_get_ascii( HISISDRV hDriver, AT_MODE nTag, WORD wLength, LPSTR lpszValue ); |
Name | Type | Description |
---|---|---|
hDriver | HISISDRV | The handle to the driver. |
nTag | AT_MODE | Specifies the ASCII tag for which to return the current value. |
wLength | WORD | Specifies the number of characters of the ASCII value to copy into lpcBuffer. |
lpszValue | LPSTR | Points to a buffer to hold at most wLength bytes of nTag. |
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
This function does not process image pixels.
The IG_ISIS_tag_get_ascii function retrieves the ASCII string that is the current value of the specified tag.
Use IG_ISIS_tag_get_ascii to retrieve the ASCII string that is the current value of the ASCII tag specified in nTag. The IG_ISIS_tag_get_length function can be used to determine the actual length of the string.
Use of IG_ISIS_tag_get_ascii on a non-ASCII tag is undefined. At best, this will cause an invalid return value or a operating system error message, and at worst will cause the system to crash.
The following code fragment uses IG_ISIS_tag_get_ascii to help determine which dither mode has been selected:
Copy Code
|
|
---|---|
/* figure out which dither mode has been selected (result in n) */IG_ISIS_tag_get_ascii(hDriver, IG_ISIS_TAG_DITHER, 128, lpcBuffer2);IG_ISIS_choice_get_count(hDriver, IG_ISIS_TAG_DITHER, &wCount); for (n=0; n<(int)wCount; n++) {IG_ISIS_choice_get_ascii(hDriver, IG_ISIS_TAG_DITHER, n, lpcBuffer1); if (!strcmp(lpcBuffer1, lpcBuffer2)) break; } |