DTWAIN_EnumCustomCaps

Top Previous Next

The DTWAIN_EnumCustomCaps function fills a DTWAIN_ARRAY with all of a Source's supported custom device capabilities.

DTWAIN_BOOL DTWAIN_EnumCustomCaps (

DTWAIN_SOURCE	Source,
LPDTWAIN_ARRAY	Array );

Parameters

Source

Specifies an open TWAIN Source.

Array

A pointer to a DTWAIN_ARRAY that will contain the capabilities retrieved.

Return Values

If the function succeeds, TRUE is returned. If the function fails, FALSE is returned.

Comments

The DTWAIN_EnumCustomCaps function fills the DTWAIN_ARRAY pointed to by Array with all of the custom device capabilities supported by the Source Source. A custom capability is one that is defined solely by the Source, and is not part of the TWAIN specification. This also means that the application that intends to use custom capabilities must be responsible for any values used when setting or getting values for the custom capability.

The DTWAIN_ARRAY type that is used is to store the capability constants is DTWAIN_ARRAYLONG.

Note that the Source should be an opened Source.

TWAIN State Transitions

The source must be opened in State 4

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function