DTWAIN_RangeCreateFromCap

Top  Previous  Next

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

 

See Also

DTWAIN Range Functions