DTWAIN_EnumSupportedCapsEx2

The DTWAIN_EnumSupportedCapsEx2 function creates and fills a DTWAIN_ARRAY with all of a Source's supported capabilities.

DTWAIN_ARRAY DTWAIN_EnumSupportedCapsEx2 ( DTWAIN_SOURCE Source );

Parameters

Source

Specifies an open TWAIN Source.

Return Values

If the function succeeds, a DTWAIN_ARRAY is returned that contains all of the supported capabilities. If the function fails, a NULL DTWAIN_ARRAY is returned. On failure, DTWAIN_GetLastError() should be called to determine the reason for the failure.

Comments

The DTWAIN_EnumSupportedCapsEx2 function fills the DTWAIN_ARRAY located at address Array with all of the device capabilities supported by the Source Source. The data type for the capability constants that will be stored in the DTWAIN_ARRAY are all type LONG.

The difference between DTWAIN_EnumSupportedCapsEx2 and DTWAIN_EnumSupportedCapsEx is that DTWAIN_EnumSupportedCapsEx2 will always query the TWAIN system for the supported capabilities, while DTWAIN_EnumSupportedCaps will save the initial set of capabilities within the Source object, thus making DTWAIN_EnumSupportedCaps function run faster on subsequent calls to DTWAIN_EnumSupportedCaps.

TWAIN State Transitions

The source must be opened in State 4

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function