5X80 Series Software Development Kit (SDK) User’s Guide 1 - 5Data Types, Structures, and Enumerated TypesThe 5X80 SDK API uses structures (see Structures and Mask Definitions beginning on page 4-1) and enumerated types (seeEnumerated Types and Definitions beginning on page 3-1) extensively . The definitions are in the include files in the 5X80 SDKpackage. All 5X80 SDK-specific structures have a dwStructSize member that must be set to sizeof( struct name ). This insuresthat the structure being passed to a given function is the structure type expected by the function and, if writing is done to thestructure, that the structure size boundary is not exceeded. Furthermore, all imager configuration structures (except the allinclusive structure HHP_CONFIG) have a DWORD member dwMask. The mask allows you to specify only certain memberswithin a structure. Set the mask value by ORing together the appropriate masks for the given structure for the particular itemswithin the structure that should be read/written. Samples of programs that demonstrate this can be found in Program Samplesbeginning on page 6-1. This technique is also used by Microsoft ® in their Windows® SDK (for example, see Windows ® SDKstructure CHARFORMAT).The following Windows ® data types are included for clarity.Note: A “P” in front of a data type means a pointer to the type.hhpGetLastImageInitiates transfer of the last image captured. (This includes images capturedduring barcode scan.) The call can be made synchronously orasynchronously, and the transfer parameters can be specified.2-5Intelligent Imaging (Signature Capture) FunctionsIntelligent imaging is barcode capture combined with an image window capture. The image window is cut from the same imageused to capture a barcode. This is how the SDK provides the ability to capture a signature associated with a barcode. In fact, asuccessful barcode capture is required before the intelligent image window is sent by the imager. You can specify whether theimage is returned grayscale or black and white.hhpAcquireIntelligentImage Barcode capture combined with an image window capture. 2-1hhpRawAcquireIntelligentImage Captures portion of the image in which a barcode is decoded. 2-6Miscellaneous FunctionshhpSendActionCommand Turns on illumination LEDs, Aimers, (and sound beeper for imagers that haveone) outside the image or barcode capture. 2-9hhpSendMessage Sends menu commands to the imager. 2-9hhpUpgradeFirmware Upgrades the current imager firmware with a new firmware file. 2-11hhpSetHardwareLineDllFileNameAllows you to specify the name of an OEM dll file. This file can contain someor all of the OemDll exports that provide support for hardware trigger and lowpower mode hardware lines.2-11Windows Data TypesBOOL 32 bit signed integer used by most Microsoft SDK functions in place of a true Boolean.BYTE 8 bit unsigned variable.DWORD 32 bit unsigned integer variable.HANDLE A Windows WIN32 handle type. Returned from opening files, creating events, semaphores, ormutexes.HWND A Windows handle to an application window.PVOID 32 bit unsigned integer that points to void data type (generic pointer).TCHAR OS-dependent character variable. 16 bit for Unicode systems, otherwise 8 bits.WORD 16 bit unsigned integer variable.HHP_EVENT_CALLBACK Pointer to a callback function (see hhpImgrSdk.h) called in response to the completion of anasynchronous 5X80 SDK function call or event. (See example on page 6-4.)Core Functions (Continued)Core Function Summary Page