Document Title Here
AET65 API
Version 1.0
idvation GmbH
Otto-Hesse-Straße 19 / T5
Phone +49 6151 9926567
D-64293 Darmstadt
Fax +49 6151 3689296
www.idvation.com
Page 26 of 84
Page 26 of 84
3.4.5.
ABSRawGrabImage
ABS_STATUS ABSRawGrabImage(
IN ABS_CONNECTION hConnection
IN ABS_OPERATION *pOperation
IN ABS_DWORD dwProfileSize
IN ABS_PROFILE_DATA *pProfileData
IN ABS_IMAGE_FORMAT *pImageFormat
OUT ABS_IMAGE **ppImage
OUT ABS_SWIPE_INFO **ppSwipeInfo
IN void *pReserved
IN ABS_DWORD dwFlags
)
Description
Grabs image sample from the FM. This function is similar to
ABSGrabImage, but it is more low level.
It specifies some special tuning parameters, thus tuning of the grab
operation for specific purposes is possible. Those flags can specify
what quality checks should be run and other options.
Please note that all these options are device specific. Various device
models tunes various aspects of the grab operations, to various
degree. Prefer ABSGrab or ABSGrabImage whenever possible.
Unlike ABSGrabImage this function waits for just one swipe and
ends even if the resulting image has low quality. The caller can use
the output parameters to further inspect quality of the resulted
sample image.
Note that if the grab profile uses key ABS_PKEY_IMAGE_FORMAT,
it is ignored, as this function always uses the format as specified by
pImageFormat parameter.
Parameters
hConnection
Handle to the connection to FM.
pOperation
See description of ABS_OPERATION.
dwProfileSize
Determines how many properties are in pProfileData.
pProfileData
Pointer to first member of profile data array.
See description of ABS_PROFILE_DATA type for more information
about the profile.
pImageFormat
Pointer to structure describing desired image format.
ppImage
Functions set the pointer to newly allocated sample image.
Use ABSFree to release the allocated memory.
ppSwipeInfo
If used (i.e. not set to NULL), an additional information about the
swipe are provided to the caller.
Use ABSFree to release the returned memory block. See description
of ABS_SWIPE_INFO for more information.
pReserved
Reserved for future use. Set to NULL.
