DTWAIN_GetLightSources
|
The DTWAIN_GetLightSources retrieves the current light sources.
DTWAIN_BOOL DTWAIN_GetLightSources (
Parameters Source An open TWAIN Source.
pLightPath Pointer to DTWAIN_ARRAY of currently used light sources.
Return Values TRUE if successful, FALSE otherwise. If the function returns FALSE, call DTWAIN_GetLastError() to get extended information.
Comments The DTWAIN_GetLightSources function gets the current light sources being used. The light source determines which lamp will be used when acquiring an image (some devices have multiple lamps). On return, LightSources will be filled with the currently used light sources.
The DTWAIN_GetLightSources function differs from DTWAIN_EnumLightSources in that DTWAIN_GetLightSources returns only the light sources that will be used, while DTWAIN_EnumLightSources returns all of the light sources that are available.
Example:
void Func( ) { DTWAIN_ARRAY LightSources; DTWAIN_SOURCE Source; LONG numLightSources; //... DTWAIN_GetLightSources( Source, &LightSources ); numLightSources = DTWAIN_ArrayGetCount( LightSources ); //... DTWAIN_ArrayDestroy( LightSources ); }
TWAIN State Transitions The Source must be in State 4. or higher
Prerequisite Function Call(s) DTWAIN Source Selection Function
See Also |