Scanner Device Property Constants
Windows Image Acquisition (WIA) hardware devices have property values that are stored in the Windows registry. For more information, see Common Device Property Constants. The following device property constants, with their associated strings, are specific to digital image scanners.
The prefix "WIA_DPS_" indicates a Device Property for Scanner devices and is the naming convention used in C/C++. For scripting purposes these constants use the prefix "ScannerDevice" and are part of the WiaItemPropertyId enumerated type. The corresponding member name from that script enumeration appears in parentheses next to the C/C++ constant name in the following list.
Constant/value | Description | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Note: This property is supported only on Windows Vista and later.
|
||||||||||||||||||||||||||||||||||||||
|
Reserved, do not use. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Reserved, do not use. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Contains the capabilities of the scanner. The minidriver creates and maintains this property. An application reads this property to determine whether the scanner has a flatbed, document feeder, or duplexer installed. This property is also used to further define the installed features. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table describes the constants that are valid with Windows 7 only.
The following table describes the constants that are valid with Windows 7 and Windows Vista only.
The following table describes the constants that are valid with Windows XP or later.
The following table describes the constants that are valid with Windows XP only. These values have been deprecated for Windows 7 and Windows Vista and should not be used.
|
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the current scanner acquisition source and mode.The minidriver creates and maintains this property. An application reads this property to determine the current acquisition source of the scanner or to write this property to set the source and mode of the scanner. In addition, applications use this property to enable and disable duplexer functionality. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_FLAG The following table has the ten constants that are valid with this property.
|
||||||||||||||||||||||||||||||||||||||
|
Contains current state of the scanner's installed flatbed, document feeder, or duplexer. The minidriver creates and maintains this property. An application reads this property to determine whether the scanner device is ready to be used. This is an ideal way to check whether paper is in the feeder prior to acquiring an image. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table has the constants that are valid with this property.An asterisk * indicates that the flag is not supported in Windows Vista or later. The V symbol indicates that the flag is supported only in Windows Vista and later.
|
||||||||||||||||||||||||||||||||||||||
|
Contains all the valid characters that an application can use to create valid endorser strings. An endorser is a printer installed on a scanner that imprints a text message on every page scanned. The minidriver should validate the setting of the WIA_DPS_ENDORSER_STRING property against the valid character set in this property. The minidriver creates and maintains this property. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Contains a string that is to be endorsed (in other words, printed) on each page that the minidriver scans. An application sets this property using the valid character set that is reported in the WIA_DPS_ENDORSER_CHARACTERS property. The minidriver should endorse documents only if a string is set in this property. An empty string means that the endorser functionality is disabled. Because it is the driver's responsibility to interpret the endorser string, your driver can use special characters in WIA_DPS_ENDORSER_STRING. However, only your applications would understand these characters. Type: VT_BSTR, Access: Read/Write, Valid values: WIA_PROP_NONE A driver supporting the WIA_DPS_ENDORSER_STRING property must support the following list of tokens.
|
||||||||||||||||||||||||||||||||||||||
|
Reserved, do not use. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the SOAP address of a web services scanner device. The WIA 2.0 mini-driver creates and maintains this property. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the registration, or horizontal alignment, for documents placed on the flatbed. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table has the three constants that are valid with this property.
See Also WIA_DPS_VERTICAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
Note: Specifies the maximum width, in thousandths of an inch, that is scanned in the horizontal (X) axis from the platen of a flatbed scanner at the current resolution. This property also applies to automatic document feeders that move sheets to the platen of a flatbed scanner for scanning. This property is mandatory for scanners that have a platen. Other scanner types will instead implement the WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Specifies the maximum width, in thousandths of an inch, that is scanned in the horizontal (X) axis from a handheld or sheet feed scanner at the current resolution. This property also applies to automatic document feeders that scan without moving sheets to the platen of a flatbed scanner. This property is mandatory for sheet-fed, scroll-fed, and hand-held scanners. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Contains the maximum time to scan a single page with the current property settings, in milliseconds. An application reads this property to estimate the time it will take to scan a page. This is helpful when determining the conditions of a device that has stopped responding. The minidriver creates and maintains this property. This property is required for all scanners. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the physical horizontal dimensions of the smallest page that the scanner's document feeder can scan, in thousandths of an inch. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE See Also WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the physical vertical dimensions of the smallest page that the scanner's document feeder can scan, in thousandths of an inch. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE See Also WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
Note: Horizontal Optical Resolution. Highest supported horizontal optical resolution in DPI. This property is a single value. This is not a list of all resolutions that can be generated by the device. Rather, this is the resolution of the device's optics. The minidriver creates and maintains this property. This property is required for all scanners. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Vertical Optical Resolution. Highest supported vertical optical resolution in DPI. This property is a single value. This is not a list of all resolutions that are generated by the device. Rather, this is the resolution of the device's optics. The minidriver creates and maintains this property. This property is required for all scanners. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Contains the current orientation setting.The minidriver creates and maintains this property. An application sets the WIA_DPS_ORIENTATION property to define the original orientation of a page or image to be acquired. For information on how to use WIA_DPS_ORIENTATION, see WIA_DPS_PAGE_SIZE Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_LIST The following table has the four constants that are valid with this property.
See Also |
||||||||||||||||||||||||||||||||||||||
|
Color used to pad when there is not enough image data to fill a requested buffer. This property is implemented for scanners that pad the buffer. This property is optional for all scanners. The minidriver creates and maintains this property. Type: VT_UI1 | VT_VECTOR, Access: Read Only, Valid values: WIA_PROP_NONE The format of the color information is RGBQUAD. |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the height, in thousandths of an inch, of the currently selected page. The minidriver creates and maintains the WIA_DPS_PAGE_HEIGHT property. An application reads this property to determine the physical dimensions of the page being scanned. If the extent settings are different from the known page sizes, this property reports the height of the page whose WIA_DPS_PAGE_SIZE property is set to WIA_PAGE_CUSTOM (which is a value of the WIA_DPS_PAGE_SIZE property). WIA_DPS_PAGE_HEIGHT must be in sync with WIA_IPS_XEXTENT, which reports the height, in pixels, of the page to be scanned. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the size of the page that is currently selected to be scanned. To select the dimensions of the page to scan, an application sets this property. The minidriver creates and maintains this property. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_LIST The following table has the three constants that are valid with this property.
The value of the WIA_IPS_ORIENTATION property determines the orientation of the currently selected page. The WIA_DPS_PAGE_WIDTH and WIA_DPS_PAGE_HEIGHT properties report the page's dimensions, in thousandths of an inch. Note that these properties must be in agreement with WIA_IPS_XEXTENT and WIA_IPS_YEXTENT, which contain the page's dimensions in pixels. Valid values of type WIA_PROP_LIST should depend on valid settings of the WIA_IPS_ORIENTATION property. If the device cannot scan landscape-oriented documents with a WIA_PAGE_A4 setting, WIA_PAGE_A4 should not appear in the list of valid values for the WIA_DPS_PAGE_SIZE property when WIA_IPS_ORIENTATION is set to LANSCAPE. If an application sets WIA_DPS_PAGE_SIZE to any value other than WIA_PAGE_CUSTOM, the minidriver should adjust the values of WIA_DPS_PAGE_WIDTH and WIA_DPS_PAGE_HEIGHT to the page's dimensions in thousandths of an inch. It should also adjust the values of WIA_IPS_XEXTENT and WIA_IPS_YEXTENT to the page's dimensions in pixels. If an extent setting (WIA_IPS_XEXTENT or WIA_IPS_YEXTENT) is changed to a value that does not match the current page-size setting, the minidriver should change the value of the WIA_DPS_PAGE_SIZE property to WIA_PAGE_CUSTOM. The minidriver should also modify WIA_DPS_PAGE_WIDTH or WIA_DPS_PAGE_HEIGHT in accordance with the new extent setting. If WIA_IPS_ORIENTATION is set to LANSCAPE, the extent settings will be "flipped." For example, if an application sets WIA_DPS_PAGE_SIZE to WIA_PAGE_A4, the minidriver should set WIA_DPS_PAGE_WIDTH to 11692 and WIA_DPS_PAGE_HEIGHT to 8267. (The minidriver should also set WIA_IPS_XEXTENT and WIA_IPS_YEXTENT accordingly.) Note that if WIA_DPS_PAGE_SIZE is set to WIA_PAGE_CUSTOM, the orientation setting is not used to determine the extent dimensions of the page to be scanned. The minidriver is responsible for ensuring that the WIA_IPS_ORIENTATION property is in agreement with the current selection area. If an application changes the value of WIA_IPS_ORIENTATION to one that is invalid for the currently selected page size, the minidriver should change the value of WIA_DPS_PAGE_SIZE to a page size that is supported by the new orientation value. If an application sets the WIA_DPS_PAGE_SIZE property to WIA_PAGE_CUSTOM, the current selection area is not affected. The WIA minidriver should obtain the current image layout, starting from the current settings of the WIA_IPS_XPOS and WIA_IPS_YPOS properties. If the page-size setting results in a selection area that is outside the scanner's bed, the minidriver must automatically adjust the values of the WIA_IPS_XPOS and WIA_IPS_YPOS properties to valid settings. If the WIA_DPS_PAGE_SIZE and WIA_IPS_ORIENTATION properties are set at the same time, and they are invalid when applied in combination, the minidriver should fail the application's settings by returning an error in the IWiaMiniDrv::drvValidateItemProperties. . The following four examples show different WIA_DPS_PAGE_SIZE scenarios.
Example 1: The minidriver reports the settings In the following example, the minidriver sets a custom selection area before an application sets any WIA properties. In this case, the selection area represents the entire flatbed.
Example 2: An application sets the WIA_DPS_PAGE_SIZE property to WIA_PAGE_LETTER
Example 3: An application sets the WIA_IPS_ORIENTATION property to LANSCAPE The physical bed must be able to acquire a page that was originally in landscape orientation.
Example 4: An application changes the WIA_IPS_XEXTENT property to a smaller value In the following example, an application changes the WIA_IPS_XEXTENT property to 1000. The minidriver should assume that the new value contained in WIA_IPS_XEXTENT is no longer valid for the WIA_DPS_PAGE_SIZE property and should thus change WIA_DPS_PAGE_SIZE to WIA_PAGE_CUSTOM. The minidriver must also adjust WIA_DPS_PAGE_WIDTH.
|
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the width of the current page selected, in thousandths of an inch. An application reads this property to determine the physical dimensions of the page being scanned. If the extent settings are different from known page sizes, this property reports the width of the page whose WIA_DPS_PAGE_SIZE property is set to WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH must be in sync with the value of WIA_IPS_XEXTENT, which reports the width, in pixels, of the page to be scanned. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the current number of pages to be acquired from an automatic document feeder. The minidriver creates and maintains this property. Type: VT_I4; Access: Read/Write; Valid values: WIA_PROP_RANGE (zero through the maximum number of pages that the document feeder can hold) An application reads this property to determine the document feeder's page capacity. The application also sets this property to the number of pages it is going to scan. Note: One sheet of paper will automatically contain two pages if DUPLEX is enabled, even if the back side of the page is blank. Setting WIA_DPS_PAGES to 1 causes a scanner to process one of the sides of the page. It is recommended that if a scanner is unable to scan only one side of a page while in duplex mode, the WIA_DPS_PAGES valid value for the Inc member of the WIA_PROPERTY_INFO structure should be changed to 2. This value signals the application that it must request pages in multiples of two. A value of zero means that all pages that are currently loaded into the document feeder are to be scanned. |
||||||||||||||||||||||||||||||||||||||
|
Specifies the color of the platen in back of the sheet to be scanned. This property is optional for scanners that have a platen. The minidriver creates and maintains this property. Type: VT_UI1 | VT_VECTOR, Access: Read Only, Valid values: WIA_PROP_NONE The format of the color information is RGBQUAD. |
||||||||||||||||||||||||||||||||||||||
|
Note: Indicates the preview mode for a device. An application sets this property to place the device into a preview mode. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_LIST The following table has the two constants that are valid with this property.
|
||||||||||||||||||||||||||||||||||||||
|
Contains a value that indicates whether the scanner will cache pages in a scanner buffer before sending them to the application. A value of zero disables scan ahead and no pages will be scanned ahead. Doing normal data transfers on the buffered scan-ahead item retrieves the buffered pages. WIA properties cannot be changed during a scan-ahead operation. This property is optional. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_RANGE of zero to the maximum number of pages that the document feeder can hold. |
||||||||||||||||||||||||||||||||||||||
|
Note: Indicates the input source (flatbed, automatic document feeder, or fil-scanning adapter) to scan from, or the storage location to transfer data from. A scan event notifies the application that the user has initiated a scan, but the event does not supply the name of the WIA item that represents the input source. The application's event handler can query the root item's WIA_DPS_SCAN_AVAILABLE_ITEM property to get the name of the input source item. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_RANGE of zero to the maximum number of pages that the document feeder can hold. |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the Service ID of a Web Services scanner device. The WIA 2.0 mini-driver creates and maintains this property. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the registration, or alignment and edge detection, for documents that are placed on the flatbed. The minidriver creates and maintains this property. This property indicates how the sheet is horizontally positioned on the scanning head of a handheld or sheet-fed scanner. The property is used to predict where across the scan head a document is placed. For scanners that support more than one scan head, this property is relative to the topmost scan head. This property is mandatory for sheet-fed, scroll-fed, and handheld scanners. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table has the three constants that are valid with this property.
|
||||||||||||||||||||||||||||||||||||||
|
Note: Indicates whether an item needs a preview control displayed to the user. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table has the two constants that are valid with this property.
|
||||||||||||||||||||||||||||||||||||||
|
Note: Used by the WIA service to inform the mini-driver about the user account name (including the network domain name when applicable) of the session in which the current WIA application is running. This is a root item property, managed by the WIA service. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Contains the registration, or vertical alignment and edge detection, for documents placed on the flatbed. The minidriver creates and maintains this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE The following table has the three constants that are valid with this property..
See Also. WIA_DPS_HORIZONTAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
Note: Specifies the maximum height, in thousandths of an inch, that is scanned in the vertical (Y) axis from the platen of a flatbed scanner at the current resolution. This property also applies to automatic document feeders, that move sheets to the platen of a flatbed scanner for scanning. This property is mandatory for scanners that have a platen. Other scanner types will instead implement the WIA_DPS_VERTICAL_SHEET_FEED_SIZE property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Note: Specifies the maximum height, in thousandths of an inch, that is scanned in the vertical (Y) axis from a handheld or sheet feed scanner at the current resolution. This property also applies to automatic document feeders that scan without moving sheets to the platen of a flatbed scanner. This property is mandatory for sheet-fed scanners. Scroll-fed and hand-held scanners should not implement this property. Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE |
Requirement | Value |
---|---|
Minimum supported client |
Windows 2000 Professional, Windows XP [desktop apps only] |
Minimum supported server |
Windows Server 2003 [desktop apps only] |
Header |
|