DTWAIN_EnumTopCameras

Top  Previous  Next

The DTWAIN_EnumTopCameras function gets all of the top "cameras" that are available for the current Source.  The Source must support TWAIN File System handling.

 

LONG DTWAIN_EnumTopCameras (

DTWAIN_SOURCE

Source,

LPDTWAIN_ARRAY

lpCameraNames );

 

Parameters

Source

An open TWAIN Source.

 

lpCameraNames

Address of a DTWAIN_ARRAY (an LPDTWAIN_ARRAY) that will store the Source's camera names.

 

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_EnumTopCameras function gets all of the supported top "cameras" that the Source Source supports.  This function is mostly used for duplex scanners and other equipment that have multiple input "cameras" that are responsible for recording the image data from the physical page.  For more information, please see Duplex Camera Processing.  The Source must support the TWAIN File System handling for this function to have any effect.

 

The lpCameraNames is the address of a DTWAIN_ARRAY of type DTWAIN_ARRAYSTRING.  On return, this array is filled with the names of each camera that the Source supports.

 

This function is identical to DTWAIN_EnumCameras, but only retrieves the cameras that are considered the "top" cameras.  See DTWAIN_EnumCameras for more information, and a sample program.

 

TWAIN State Transitions

The Source must be in State 4 or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

 

 

See Also

Duplex Camera Processing