MagTek Excella Windows API99875313 - Manual (Page 38)

Excella Windows API Specifications
30
MTMICRGetImages
MTMICRGetImages is similar to MTMICRGetImage except MTMICRGetImages can get multiple images in
one function call.
ULONG MTMICRGetImages (
char
*pcDevName,
GET_IMAGE *pGetImage,
DWORD
dwTotalImages
);
Parameters
pcDevName
Pointer to null terminated string containing device name .
pGetImage
Pointer to a list of GET_IMAGE structures containing the image information .
typedef struct _GET_IMAGE
{
char *pcImageId;
char *pcBuffer;
DWORD dwBufferLength;
DWORD dwBytesReturned;
DWORD dwStatus;
} GET_IMAGE;
pcImageId = ImageURLx returned by the MTMICRProcessCheck in the document information. Where x is
the image index.
pcBuffer = Allocate memory required to store the image. The image size is also returned in the document
information from the MTMICRProcessCheck.
dwBufferLength = Size of pcBuffer in bytes .
dwBytesReturned = MTMICRGetImages will store the number of bytes returned by the device.
dwStatus = MTMICRGetImages fills the status of each image.
dwTotalImages
Number of Images requested.
Return Values
MICR_ST_OK
MICR_ST_DEVICE_NOT_RESPONDING
MICR_ST_IMAGE_NOT_FOUND
MICR_ST_NOT_ENOUGH_MEMORY
MICR_ST_ERR_INTERNET_CONNECT
MICR_ST_ERR_HTTP_OPEN_REQUEST
MICR_ST_ERR_HTTP_SEND_REQUEST