DTWAIN_EnumSourceUnits

Top Previous Next

The DTWAIN_EnumSourceUnits gets all of the current unit of measure supported by the Source.

DTWAIN_BOOL DTWAIN_EnumSourceUnits (

DTWAIN_SOURCE	Source,
LPDTWAIN_ARRAY	lpArray );

Parameters

Source

Specifies a TWAIN Source.

lpArray

Address of DTWAIN_ARRAY that receives all of the supported units of measure.

Return Values

If the function succeeds, TRUE is returned. If unsuccessful, FALSE is returned.

Comments

The DTWAIN_EnumSourceUnits function gets all of the units of measure used by the Source. On successful return, the units of measure are stored in the DTWAIN_ARRAY located at the address lpArray. The units of measure in the DTWAIN_ARRAY are all of type LONG.

The unit of measure determines which unit the Source is using when describing certain quantities such as image size. For more information on units of measure used by the Source, see Units of Measure and Image Acquisition.

TWAIN State Transitions

The Source must be in State 4 or higher.

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function