WIA_IPS_DOCUMENT_HANDLING_SELECT

The WIA_IPS_DOCUMENT_HANDLING_SELECT property contains the current scanner acquisition source and mode.

Property Type: VT_I4

Valid Values: WIA_PROP_FLAG

Access Rights: Read/write

Remarks

An application reads the WIA_IPS_DOCUMENT_HANDLING_SELECT property to determine the current acquisition source of a scanner, or the application writes this property to set the source and mode of the scanner. In addition, applications use this property to enable and disable duplexer functionality. The WIA minidriver creates and maintains this property.

The following table describes a constant that is valid with Windows Vista and later only.

ValueDefinition

ADVANCED_DUPLEX

Scan by using individual configuration settings for each child feeder item (WIA_CATEGORY_FEEDER_FRONT and WIA_CATEGORY_FEEDER_BACK). This flag cannot be set together with DUPLEX.

A device that supports different scan settings for the front and back items should implement the optional ADF front and back items and it should support both DUPLEX and ADVANCED_DUPLEX.

 

The following table describes the constants that are valid with Windows Vista and Windows XP.

ValueDefinition

BACK_FIRST

Scan the back of the document first. This value is valid only when DUPLEX is set.

BACK_ONLY

Scan the back only. This value is valid only when DUPLEX is set.

DUPLEX

Scan by using duplexer operations.

FRONT_FIRST

Scan the front of the document first. This value is valid only when DUPLEX is set.

FRONT_ONLY

Scan the front only.

 

The values DUPLEX and FRONT_ONLY are mutually exclusive--set one or the other, but not both.

A WIA 2.0 minidriver must set the initial value of this property to its default value, FRONT_ONLY. Failure to observe this requirement might make the minidriver incompatible with the WIA 1.0 common scan dialog and with some WIA 1.0 applications.

The following table describes the constants that are valid with Windows XP but are obsolete with Windows Vista and later.

ValueDefinition

AUTO_ADVANCE

Enable automatic feeding of the next document after a scan.

FEEDER

Scan by using the document feeder.

FLATBED

Scan by using the flatbed.

NEXT_PAGE

Scan the next page of the document.

PREFEED

Enable pre-feed mode. Position the next document while scanning.

 

Requirements

Version

Available in Windows Vista and later operating systems. For Windows XP, use the identical WIA_DPS_DOCUMENT_HANDLING_SELECT property.

Header

Wiadef.h (include Wiadef.h)

See also

WIA_DPS_DOCUMENT_HANDLING_SELECT

 

 

Send comments about this topic to Microsoft

Show: