MagTek Excella Windows API99875313 - Manual (Page 35)

Section 3. Excella API
27
MTMICRProcessCheck
MTMICRProcessCheck function sends a scan check request with the given process options to the given device
name. When the device completes the scan request, the result of the scan is returned in the buffer pcDocInfo.
ULONG MTMICRProcessCheck (
char *pcDevName,
char *pcProcessOptions,
char *pcDocInfo,
DWORD *pdwDocInfoSize
);
Parameters
pcDevName
Pointer to null terminated string containing device name.
pcProcessOptions
Pointer to a buffer containing the options to be used in processing the check. The options are stored in
the buffer by using function MTMICRSetValue or function MTMICRSetIndexValue.
pcDocInfo
Pointer to the buffer containing the information returned from the device. The returned information
contains command status , MICR data, and image information.
pdwDocInfoSize
Size of the buffer pcDocInfo.
Return Values
MICR_ST_OK
MICR_ST_DEVICE_NOT_OPEN
MICR_ST_BAD_PARAMETER
MICR_ST_NOT_ENOUGH_MEMORY
Remarks
If the function succeeds MICR_ST_OK is returned.
Example
#define BUFFER_LEN 4096
char docInfo [BUFFER_LEN];
char options [BUFFER_LEN];
char Device[4096] ="";
DWORD docInfoSize;;
// Set up options using function MTMICRSetValue or function MTMICRSetIndexValue
// Use function MTMICRGetDevice to get device name for variable “Device”
docInfoSize = BUFFER_LEN;
dwStatus=MTMICRProcessCheck(Device, options, docInfo, &docInfoSize);
// Use MTMICRGetValue and MTMICRGetIndexValue to parse the docInfo.