This function confirms whether or not a functionality is supported by the scan device
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 whether the power is on or off on the device 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 In Delphi, replace 0x with $. In Visual Basic, replace 0x with &H |
| 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 whether the power is on, 0: Power is off, 1: Power is on.
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 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.
* 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.