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 37 of 84
Page 37 of 84
4.0. BSGUI.DLL Functions
4.1. Using BSGUI.DLL
BSGUI.DLL provides a default ABS_CALLBACK implementation for BSAPI.DLL.
To use the default callback implementation, link your application with both BSAPI.DLL and BSGUI.DLL.
Therefore, whenever any interactive operation is started, set member Callback of structure
ABS_OPERATION to pointer to function ABSDefaultCallback from BSGUI.DLL.
When installing the application, file BSGUI.ZIP must be placed to the same directory as the BSGUI.DLL.
Please note that BSGUI.DLL is available only for Windows platform.
4.2. GUI Customization
The BSGUI.DLL library loads graphics from file BSGUI.ZIP.
If you want to customize look and feel of the dialogs provided by BSGUI.DLL, replace some or all images in
the BSGUI.ZIP file and, if necessary, change also layout in BIO.XML inside the BSGUI.ZIP.
4.3. Default Callback Implementation
4.3.1.
ABSDefaultCallback
void ABSDefaultCallback(
IN const ABS_OPERATION *pOperation
IN ABS_DWORD dwMsgID
IN void *pMsgData
)
Description
Default BSAPI callback implementation.
It provides default implementation of callback, which can be passed into
BSAPI interactive functions via ABS_OPERATION structure. Using this
callback instead of your own implementation provides consistent look and
feel across applications.
You should never call this function directly. It's intended only to pass
pointer to the function into the BSAPI functions as member Callback of
structure ABS_OPERATION.
For more information, see the documentation of type ABS_CALLBACK and
structure ABS_OPERATION.
Parameters
pOperation
Pointer to ABS_OPERATION structure used when calling the interactive
biometric operation.
The caller of the interactive operation can use member Context of the
structure to pass data into the default callback. ABSDefaultCallback
expects the data in the form of ABS_DEFAULT_CALLBACK_CONTEXT
structure.
The Context pointer can be set to NULL. In that case, default behavior is
used.
dwMsgID
ID of message. See description of ABS_MSG_xxxx constants.
pMsgData
Pointer to data with additional information related with the message.
Its meaning is message-dependent. Refer to documentation of specific
ABS_MSG_xxxx constants.
