DTWAIN_RangeCreateFromCap

The DTWAIN_RangeCreateFromCap creates a DTWAIN_RANGE that is compatible with a device capability's value(s).

DTWAIN_RANGE DTWAIN_RangeCreateFromCap (

DTWAIN_SOURCE	Source,
LONG	CapValue );

Parameters

Source

A valid DTWAIN_SOURCE if CapValue is a custom capability. NULL otherwise.

CapValue

Device capability to use when creating array.

Return Values

If the function succeeds, a new DTWAIN_RANGE is returned. Otherwise, NULL is returned.

Comments

The DTWAIN_RangeCreateFromCap function returns a new DTWAIN_RANGE of the type that is the same type that the device capability CapValue will need to store values. The DTWAIN_RangeCreateFromCap function can be used to create a DTWAIN_RANGE that is to be used for the DTWAIN_SetCapValues function. If the capability CapValue is a custom capability (the capability value is >= 32,768), the Source argument must be a valid DTWAIN_SOURCE that supports the custom capability. Otherwise, the Source argument should be NULL.

TWAIN State Transitions

None.

Prerequisite Function Call(s)

DTWAIN_SysInitialize