DTWAIN_FRAME Functions

The following functions are used to initialize a DTWAIN_FRAME data type.  The DTWAIN_FRAME emulates the TWAIN TW_FRAME structure.

Creating a DTWAIN_FRAME:

DTWAIN_FrameCreate

Destroying a DTWAIN_FRAME:

DTWAIN_FrameDestroy

Setting DTWAIN_FRAME limits, step, current/default values:

DTWAIN_FrameSetAll

DTWAIN_FrameSetValue

Retrieving DTWAIN_FRAME limits, step, current/default values:

DTWAIN_FrameGetAll

DTWAIN_FrameGetValue

In addition to the functions above, any of the DTWAIN_ARRAY functions can also be used for DTWAIN_FRAME types.  The DTWAIN_FRAME is a specialized version of a DTWAIN_ARRAY.

Given the above, remember that a DTWAIN_FRAME is a DTWAIN_ARRAY, but a DTWAIN_ARRAY may not be a valid DTWAIN_FRAME.  You can easily render a DTWAIN_FRAME invalid by removing or adding values from it by using the DTWAIN_ARRAY functions.  The safest DTWAIN_ARRAY functions to use on DTWAIN_FRAMEs would be functions that do not change the values in an existing DTWAIN_FRAME.  For example, DTWAIN_ArrayGetCount, DTWAIN_ArrayCreateCopy, etc.