DTWAIN_ArrayGetCapValues

The DTWAIN_ArrayGetCapValues function gets the capability value(s) for a Source.

DTWAIN_ARRAY DTWAIN_ArrayGetCapValues (

DTWAIN_SOURCE	Source,
LONG	Capability,
LONG	GetType );

Parameters

Source

An open TWAIN Source.

Capability

The capability that is to be retrieved.

GetType

Indicates which type of retrieval to do

Return Values

The return value is a DTWAIN_ARRAY containing the values retrieved. NULL is returned if the capability does not exist for the Source, or if there is some other error retrieving the capability.

Comments

The DTWAIN_ArrayGetCapValues function works exactly the same as DTWAIN_GetCapValues, except that the DTWAIN_ARRAY is returned instead of the programmer having to provide the address of an existing DTWAIN_ARRAY.

If the returned DTWAIN_ARRAY is NULL, you should call DTWAIN_GetLastError to determine the cause of the failure.

TWAIN State Transitions

The Source must be in State 4 or higher (depending on the capability).

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function