Oemgetapirevision, Oemgetdecodeattemptlimit, Oemgetdecodecenteringwindow – Hand Held Products 4X00 User Manual

Page 18

Advertising
background image

2 - 4

IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide

oemGetAPIRevision

This function returns an ASCII string containing the API's current revision.

Result_t

oemGetAPIRevision (
TCHAR *pszRev
)

Return Values

RESULT_SUCCESS always

Parameters

pszRev

Upon successful return, this null-terminated string is filled in with the revision level of the API. The caller must allocate
at least ENGINE_API_RESPONSE_LEN bytes for this string.

oemGetDecodeAttemptLimit

This function is used to retrieve the current decode attempt maximum time limit. The limit, specified in milliseconds, is the
maximum amount of time the decoder may use to attempt a decode on the current image.

Result_t

oemGetDecodeAttemptLimit (
SetupType_t SetupType,
WORD *nLimit
)

Return Values

RESULT_SUCCESS
RESULT_ERR_UNSUPPORTED
RESULT_ERR_PARAMETER

Parameters

Setup Type

SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings.

pnLimit

Points to a word variable that upon return of RESULT_SUCCESS will contain the decode attempt maximum time limit.
A value of zero indicates no limit.

oemGetDecodeCenteringWindow

This function returns the Enabled/Setup information for decode centering mode. In this mode, a decode call is only successful
if the area bounding the decoded symbol intersects a caller defined rectangle located about the center of the captured image.

Note: This function allows the engine to discriminate symbols that are located physically close to each other so only one symbol

is captured during decode. Only the symbol intersecting the intersection rectangle is returned.

Result_t

oemGetDecodeCenteringWindow (

SetupType_t SetupType,
BOOL *pbEnabled,
RECT *pIntersectRect
)

Return Values

RESULT_SUCCESS
RESULT_ERR_PARAMETER

Advertising