DTWAIN_ARRAY Storage Types

Top  Previous  Next

There are different DTWAIN_ARRAY types that depend on the type of data that each one stores.  A DTWAIN_ARRAY may contain a sequence of integers, floating point values, DTWAIN_SOURCE's, Strings, and other data types.   When a DTWAIN_ARRAY is initialized by the application using DTWAIN_ArrayCreate, the data type must also be specified.  The supported data types and DTWAIN_ARRAY constants that define each type are as follows:

 

Data type

DTWAIN_ARRAY constant

DTWAIN_SOURCE

DTWAIN_ARRAYSOURCE

DTWAIN_FLOAT

DTWAIN_ARRAYFLOAT

LONG        

DTWAIN_ARRAYLONG

LONG64

DTWAIN_ARRAYLONG64

DTWAIN_STRING

DTWAIN_ARRAYSTRING

LPVOID

DTWAIN_ARRAYANY

DTWAIN_FRAME

DTWAIN_ARRAYFRAME

HANDLE

DTWAIN_ARRAYHANDLE

DTWAIN_BOOL

DTWAIN_ARRAYLONG

 

All integer variables are stored as LONGS, including DTWAIN_BOOL.  DTWAIN expects the application to always use LONG variables when sending or retrieving integers from a DTWAIN_ARRAY.  If not, fatal runtime errors (General Protection Faults and Exceptions) may occur.  Whenever your application initializes a DTWAIN_ARRAY, it must specify the type of data the array will store.  The DTWAIN_ARRAY constant defined above is used to specify the type.