DTWAIN_GetLightPath

The DTWAIN_GetLightPath retrieves the current light path (reflective or transmissive).

DTWAIN_BOOL DTWAIN_GetLightPath (

DTWAIN_SOURCE	Source,
LPLONG	pLightPath );

Parameters

Source

An open TWAIN Source.

pLightPath

Pointer to the light path currently in use.

Return Values

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

Comments

The DTWAIN_GetLightPath function gets the current setting of the scanner's light path. On return pLightPath contains the current light path setting (either DTWAIN_LP_REFLECTIVE or DTWAIN_LP_TRANSMISSIVE). If the device does not have TWAIN support for light path's, FALSE is returned.

Transmissive scanning is required if scanning films or transparencies. Reflective scanning is used for normal (paper) scanning. To set the light path, call DTWAIN_IsLightPathSupported. To determine if the device supports setting the light path, call DTWAIN_IsLightPathSupported. To set the current light path, call DTWAIN_SetLightPath.

TWAIN State Transitions

The Source must be in State 4. or higher

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function