FASTCONFIG

typedef struct _FASTCONFIG
{

   L_UINT   uStructSize;
   L_UINT   uTransferMode;
   L_INT    nFileFormat;
   L_UINT32 ulBufferSize;
   L_UINT   uTime;
   L_INT    nBitsPerPixel;
   L_BOOL   bSuccess;
} FASTCONFIG, L_FAR * pFASTCONFIG;

The FASTCONFIG structure provides information about a scan configuration to be tested or a scan configuration that is the result of testing.

Member

Description

uStructSize

Size of the FASTCONFIG structure, in bytes, for versioning. Use the sizeof() macro to calculate the value.

uTransferMode

Transfer mode for the scan configuration(s). The possible values are:

 

Value

Meaning

 

LTWAIN_FILE_MODE

[0x001] Use File transfer mode

 

LTWAIN_BUFFER_MODE

[0x002] Use Memory transfer mode

 

LTWAIN_NATIVE_MODE

[0x004] Use Native transfer mode

nFileFormat

Determines the file format that will be used to save scanned images using this scan configuration. Possible values depend on the value of uTransferMode.

 

If uTransferMode is LTWAIN_FILE_MODE, the possible values are:
TWFF_TIFF
TWFF_PICT
TWFF_BMP
TWFF_XBM
TWFF_JFIF
TWFF_FPX
TWFF_TIFFMULTI
TWFF_PNG
TWFF_SPIFF
TWFF_EXIF

 

If uTransferMode is LTWAIN_BUFFER_MODE, the possible values are:
FILE_FAX_G4
FILE_FAX_G3_2D
FILE_FAX_G3_1D
FILE_FAX_G3_1D_NOEOL
FILE_JBIG
FILE_TIF_JPEG
FILE_JPEG_411
FILE_JPEG_422
FILE_JPEG
FILE_TIF

 

If uTransferMode is LTWAIN_NATIVE_MODE, the possible values are:
FILE_CCITT_GROUP4
FILE_BMP
FILE_JPEG
FILE_TIF

ulBufferSize

Determines the buffer size that will be used with the buffer transfer mode. If this value is 0, then use the twain driver preferred buffer size.

uTime

The amount of time required to scan the pages used for testing the scan configuration. The number of pages depends on how many pages the user loads in the scanner when testing a scan configuration. The same pages should be used for each test.

nBitsPerPixel

Bits per pixel that will be used.

bSuccess

Specifies whether the configuration being tested succeeded. Possible values are:

 

Value

Meaning

 

TRUE

The current scan configuration was successful.

 

FALSE

The current scan configuration was not successful.

Comments

pFASTCONFIG is a pointer to a FASTCONFIG structure. Where the function parameter type is pFASTCONFIG, you can declare an FASTCONFIG variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pFASTCONFIG variable is necessary only if your program requires a pointer.

FASTCONFIG is used with the LTwain::FindFastConfig, LTwain::GetScanConfigs and LTwain::FreeScanConfig functions.