DTWAIN_EnumSources

Top Previous Next

The DTWAIN_EnumSources function gets a list of all of the installed Sources.

DTWAIN_BOOL DTWAIN_EnumSources ( LPDTWAIN_ARRAY lpArray );

Parameters

lpArray

Address of a DTWAIN_ARRAY that will be filled with all of the Sources.

Return Values

If successful, the return value is TRUE. If there are no Sources or if there is an error, FALSE is returned.

Comments

The DTWAIN_EnumSources function fills a DTWAIN_ARRAY with a list of all of the Sources that are installed. The DTWAIN_ARRAY is of type DTWAIN_ARRAYSOURCE. Each element of The DTWAIN_ARRAY is a DTWAIN_SOURCE. The DTWAIN_SOURCEs contained in the DTWAIN_ARRAY can only be used by the Source Information Functions

The DTWAIN_SOURCEs obtained by DTWAIN_EnumSources cannot be used for image acquisition since they have not been previously selected using a DTWAIN Source Selection function. You can use the DTWAIN_GetSourceProductName function to retrieve the Source's product name, and then use the name in the DTWAIN_SelectSourceByName function to select the Source.

Example

TWAIN State Transitions

None

Prerequisite Function Call(s)

DTWAIN_SysInitialize