Hand Held Products 4X00 OemGetAPIRevision, OemGetDecodeAttemptLimit, OemGetDecodeCenteringWindow

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

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