ScanningManager.Diagnose method

Runs a scanner diagnostic by scanning a test sheet. If there is a problem feeding or reading the sheet, it will present the Scanner Error Dialog; user may choose to fix the problem or stop scanning.

This feature is invaluable to support personnel and is used to determine whether or not the scanner hardware is functioning properly. All embedded application developers are advised to bundle scanner diagnostics with their applications.

Diagnose method differences:  

1. Diagnose uses the infrared (pencil read) light source. This means the form used when performing the Diagnose must have been designed as a pencil-read form and have response positions marked with a number 2 pencil. Using an ink-read form that has response positions marked with blue or black ink will not produce accurate results.
2. Diagnose2 allows you to select the light source for the diagnostic scan.
3. Diagnose3 allows you to specify a ScanTools Plus SDS StxAppDef file to load. Light source, form ID marks, skew marks, scan speed, and OMR read spacing from the SDS StxAppDef file will be used for the diagnostic scan.
   
   TIP: If skew marks are defined for the scanned sheet and you are using an iNSIGHT 20 or iNSIGHT 30 scanner, skew correction will be performed to improve read quality.

Valid

See Scanning Manager States and Valid Properties/Methods

See ScanningManager Events and Valid Properties/Methods

IDL

HRESULT Diagnose(

[in] L_DIAGMODE_ENUM Mode,

[in] L_PORT_ENUM Port);

HRESULT Diagnose2(

[in] L_DIAGMODE_ENUM Mode,

[in] L_PORT_ENUM Port,

[in] L_LIGHT_SOURCE_ENUM);

HRESULT Diagnose3(

[in] L_DIAGMODE_ENUM Mode,

[in] L_PORT_ENUM Port,

[in] SDS_File_Spec;

Input Parameters

Exceptions

Scanning Services Exceptions

Permission Denied exception for un-trusted callers

See also

How to Diagnose a Scanner

How to Manage the Connection to ScanTools Plus Link Runtime