How to get check images, Process options, Error reporting – MagTek IMAGESAFE99875500 User Manual
Page 14: Debugging api
ImageSafe Windows API Specifications
6
HOW TO GET CHECK IMAGES
To get a check image, follow these steps:
1. The function
MTMICRProcessCheck
contains information of the process operation
provided by ImageSafe device after it completes document processing. Use this
information to find the information of the scanned images in the ImageInfo section. The
ImageInfo section contains the size of the image and the image identification for each
image.
2. Use function
MTMICRGetValue
or function
MTMICRGetIndexValue
to retrieve the size
and the URL of each image. Allocate memory for each image according to its given size.
3. Use function
MTMICRGetImage
to get one image at a time or function
MTMICRGetImages
to get all images at once. The image data is transferred to the buffer
that has memory allocated.
PROCESS OPTIONS
Process options are stored as key/value pairs in a buffer. The structure of the options follows
XML format. Use function
MTMICRSetValue
or function
MTMICRSetIndexValue
to add an
option to this structure. Options are string-based key/value pairs. Each option is stored only
once in the buffer. Function
MTMICRGetValue
and function
MTMICRGetIndexValue
can be used
to retrieve a key/value pair from this buffer.
ERROR REPORTING
When a document is processed, if there is an error in the ImageSafe device or in the processing
operation, the error is returned in the function
MTMICRProcessCheck
. Use function
MTMICRGetValue
or function
MTMICRGetIndexValue
to retrieve the error information. Table 4-
13 to table 4-20 list return codes and return messages from ImageSafe.
If an error occurs due to the failure of API function, the error is returned as the return code of the
API provided by MTXMLMCR.dll. Appendix B contains a list of errors returning from
MTXMLMCR.dll
DEBUGGING API
On the ImageSafe Demo GUI program, there is an option to enable the error logging function. If
this option is enabled, all errors returned from the device are logged into log file named
“STXDemo.log”. This file resides in the ImageSafe Demo program installation directory.