This function confirms whether or not a functionality is supported by the scan device

[C++Builder]   BOOL IKScanIsCapSupported(HANDLE AppHandle, HANDLE SrcHandle, LPCSTR ScanDsName, WORD CapNo, int *Value);
[Delphi]   function IKScanIsCapSupported(AppHandle, SrcHandle: THandle; ScanDsName: PAnsiChar; CapNo: Word; var Value: Integer): LongBool;

Parameters

Name Explanation
AppHandle The application handle retrieved by IKScanInitialize
SrcHandle The scan device handle retrieved by IKScanOpenDS or 0
ScanDsName The datasource name (Required when SrcHandle is 0)
CapNo The number for the retrieved functionality (hexadecimal)
0x1002 Document feeder function
0x1003 A function that checks whether or not there is paper in the document feeder
0x100b Indicator
0x100e UI control function
0x100f A function that checks the device's operating state
0x1011 A function to transfer thumbnail images
0x1012 Duplex scanning with document feeder
0x1014 Displays UI that sets scan values only (not to scan)
0x1015 Retrieve or set scan values in the UI
0x112d Undefined image size
0x112e A function that checks the number of images in a digital camera
0x1150 Auto border detection
0x1151 Deskew
0xf003 Maximum resolution when using the moire filter
0xf005 Rotate backside when using an ADF in duplex mode
0xf008 Auto detect BW/Color ratio
0xf009 Multistream
0xf00a Text orientation recognition or automatic rotation
0xf00c Punch hole removal
0xf00d Focus Postion
0xf00e Text Enhancement
0xf00f Border Adjustment
0xf010 Gamma Adjustment
* In Delphi, replace 0x with $.
Value A variable containing the retrieved condtions for a functionality.
See explanation, "Regarding the values returned in the Value parameter" below:

Return Value

Returns True (nonzero) when successful, returns False (0) when not successful.

Explanation

If using the value retrieved from IKScanOpenDS in SrcHandle, then no other application can use the opened datasource (scan device) until the datasource is closed. If SrcHandle is 0 and ScanDsName is blank then you must execute the IKScanSelect function. ("" or null means the datasource selected by IKScanSelect will be used)

Regarding the values returned in the Value parameter:

When CapNo refers to document feeder function, 0: document feeder not possible but document plate is possible, 1: document feeder is possible, 2: both document plate and document feeder are possible

When CapNo refers to the function that checks whether or not there is paper in the document feeder, 0: there is no paper, 1: there is paper.

When CapNo refers to indicator, 0: cannot use indicator, 1: can use indicator

When CapNo refers to UI control function, 0: must use manufacturer's UI only, 1: manufacturer's UI can be suppressed.

When CapNo refers to the function that checks the device's operating state, 0: Device does not respond, 1: Device is operating.

When CapNo refers to the function that transfers thumbnail images, 0: cannot transfer thumbnails, 1: can transfer thumbnails

When CapNo refers to duplex scanning with the document feeder, 0: cannot scan both sides, 1: can scan both sides at once, 2: can scan both sides but takes two scans

When CapNo refers to displaying UI in order to set scan values, 0: cannot display UI in order to set scan values, 1: can display UI in order to set scan values

When CapNo refers to the function that retrieves values from UI or sets values to the UI, 0: cannot retrieve or set values in the UI, 1: can retrieve or set values in the UI

When CapNo refers to the undefined size then in general, 0: undefined size cannot be used, 1: undefined size can be used.
However, with certain Epson scan drivers, the following values are set, 0: undefined size cannot be used, 1: possible only with document plate, 2: possible only with ADF, 3: possible with both document plate and ADF

When CapNo refers to how many images are in a digital camera, the returned number is the number of images.

When CapNo refers to border detection, 0: border detection is not possible, 1: border detection is possible

When CapNo refers to deskew, 0: cannot use deskew, 1: can use deskew, 2: can use deskew with smoothing.
2 is only available for certain Panasonic scan drivers.

When CapNo refers to the maximum resolution when using a moire filter, the value is that maximum resolution.
Available only for certain Epson scan drivers

When CapNo refers to RotateBack when using ADF in duplex mode, 0: rotating the back side is not possible, 1: rotating the back side is possible.
Available only for certain Epson "Epson Scan" scan drivers.

When CapNo refers to automatically detecting ratio of BW/Color, 0: cannot automatically detect BW/Color, 1: can automatically detect BW/Color.
Available for certain Panasonic scan drivers, Canon DR scan drivers, Epson scan drivers, and PFU scan drivers.

When CapNo refers to multistream, 0: Multistream is not possible, 1: Multistream is possible. In this case, multistream means scanning a single document and retrieving 2 images of different pixel type.
Available only for certain Canon DR scan drivers, Panasonic scan drivers, Epson scan drivers, or PFU scan drivers.

When CapNo refers to Text orientation recognition or automatic rotation, 0: Orientation recognition or automatic rotation is not possible, 1: Orientation recognition or automatic rotation is possible.
Available only for certain Canon DR scan drivers or Panasonic scan drivers. Canon DR scan drivers use "text orientation recognition". Panasonic scan drivers use "document orientation adjustment". Scan drivers that support TWAIN specification's "automatic rotation" also use the CapNo.

When CapNo refers to Punch Hole Removal, 0: punch hole removal not possible, 1: punch hole removal possible.
Available only for certain Canon DR scan drivers, Epson scan drivers, Panasonic scan drivers, and PFU scan drivers.

When CapNo refers to Border (border correction), 0: Border correction not possible, 1: Border correction possible.
Available only for certain Epson scan drivers and Panasonic scan drivers.

When the CapNo refers to Border Adjustment, 0: border adjustment is not possible, 1: border adjustment is possible. Enabled for certain Epson scan drivers, Panasonic scan drivers.

When the CapNo refers to Gamma Adjustment, 0: gamma adjustment is not possible, 1: gamma adjustment is possible. Enabled for certain Epson scan drivers.

* If the return value of this method is False(0), then the Value parameter is not set

[Differences from ImageKit6]

CapNo referring to undefined image size, functions that checks the number of images in a digital camera, auto border detection, deskew, maximum resolution when using the moire filter, rotate backside when using an ADF in duplex mode, and auto detect BW/Color ratio were added with the ImageKit7

[Differences from ImageKit7]

CapNo referring to multistream, text orientation recognition or automatic rotation, punch hole removal were added with the ImageKit8. Also the value of 2 was added to the document feeder function.

[Differences from ImageKit8]

Border Adjustment and Gamma Adjustment values have been added to CapNo.

 

The ImageKit9 VCL is a product created by Newtone Corporation