You are here: Programmers Reference > Programmer's Reference > Deprecated Items > Diagnose

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

Mode

Identifies how to display the diagnostic data. Mode is of type L_DIAGMODE_ENUM.

Port

Identifies the port with the scanner on which to run the diagnostic test. Port is of type L_PORT_ENUM. See L_PORT_ENUM for all values.

LightSource (for Diagnose2 only)

Identifies which light source to use for the diagnostic scan. LightSource is of type L_LIGHT_SOURCE_ENUM.

SDS_File_Spec (for Diagnose3 only)

Identifies the SDSStxAppDef file, and the path to it, to load and use for the diagnostic scan. SDS_File_Spec is of type String.

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

 

 

See Help on Help for additional information on using this help file.

See Scantron Technical Support for additional information on technical support and training options.

See the ScanTools Suite System Requirements for further details on hardware and software requirements.

ScanTools is a suite of products; the specific information you want may appear in the help for a different module. If you don't find what you're looking for here, try one of the following:

  

Scantron Corporation

Customer Service (forms, products, and services):

1-800-SCANTRON (722-6876)

www.scantron.com

Technical Support:

1-800-445-3141

[email protected]

Copyright © 1998-2012 Scantron Corporation. All rights reserved. Use permitted only under license. www.scantron.com. No part of the Help or user guides may be reproduced in any form, or by any means, without express permission from Scantron Corporation.

LINKS TO THIRD PARTY SITES

This help system may contain links to third party websites ("Linked Sites"). The Linked Sites are not under the control of Scantron and Scantron is not responsible for the content of any Linked Site, including without limitation any link contained in a Linked Site or any changes or modifications to a Linked Site. Scantron is not responsible for web casting or any other form of transmission received from any Linked Site. Scantron provides Users with the ability to link the Assessment System to the Linked Sites as a convenience to you, and the inclusion of any link does not imply endorsement by Scantron of the Linked Site or any association with its operators.