WIA_IPA_ITEM_CATEGORY
The WIA_IPA_ITEM_CATEGORY property contains grouped categories for WIA items.
Property Type: VT_CLSID
Valid Values: WIA_PROP_NONE
Access Rights: Read-only
Remarks
The WIA minidriver creates and maintains this property.
WIA defines the following categories:
| Category | Description |
|---|---|
| WIA_CATEGORY_BARCODE_READER | A barcode reader item that is a programmable data source, transfer enabled to download barcode metadata. |
| WIA_CATEGORY_ENDORSER | The endorsing category of a programmable data source item that represents both imprinting and endorsing, and can be transfer enabled to upload and download the data content to be printed/endorsed. |
| WIA_CATEGORY_FEEDER | A feeder item that is a programmable data source that follows the standard rules and that has the WIA properties that are required to support document feeders. |
| WIA_CATEGORY_FEEDER_BACK | A programmable data source item that describes the back side data source of a duplex base feeder item (WIA_CATEGORY_FEEDER). |
| WIA_CATEGORY_FEEDER_FRONT | A programmable data source item that describes the front side data source of a duplex base feeder item (WIA_CATEGORY_FEEDER). |
| WIA_CATEGORY_FILM | A film item that is a programmable data source that follows the standard rules and that has the WIA properties that are required to support film-scanning units. |
| WIA_CATEGORY_FINISHED_FILE | Not a programmable data source. The device provides data in a finished file format or in a folder item that contains the finished-file-format item. |
| WIA_CATEGORY_FLATBED | A flatbed item that is a programmable data source that follows the standard rules and that has the WIA properties that are required to support flatbed-platen scanning. |
| WIA_CATEGORY_FOLDER | A folder storage item (not a programmable data source) containing other folder items and/or finished files. |
| WIA_CATEGORY_IMPRINTER | The imprinting category of a programmable data source item that represents both imprinting and endorsing, and can be transfer enabled to upload and download the data content to be printed/endorsed. |
| WIA_CATEGORY_MICR_READER | A (Magnetic Ink Character Recognition) MICR reader item that is a programmable data source, transfer enabled to download MICR text. |
| WIA_CATEGORY_PATCH_CODE_READER | A patch code reader item that is a programmable data source, transfer enabled to download patch code metadata. |
| WIA_CATEGORY_ROOT | The root item for the device. |
| WIA_CATEGORY_AUTO | In Windows 7 and later, an auto item has the WIA properties that are required to support auto-configured scanning. |
The preceding categories define how a WIA item should be treated or used. For example, if the item represents a finished file, you can assume that the data is static and located on the device. If the item represents a feeder, you can expect it to contain the required document-feeder properties and to operate like a document feeder. For more information about these categories, see WIA Item Categories.
The following table shows the WIA grouped categories and their item flags. This table doesn't include a full list of all of the WIA item flags that WIA defines. For a complete list of these flags, see WIA_IPA_ITEM_FLAGS.
| WIA category | WIA item flags |
|---|---|
| WIA_CATEGORY_BARCODE_READER | WiaItemTypeProgrammableDataSource Required WiaItemTypeTransfer WiaItemTypeFile |
| WIA_CATEGORY_ENDORSER | WiaItemTypeProgrammableDataSource WiaItemTypeImage Optional WiaItemTypeTransfer WiaItemTypeFile |
| WIA_CATEGORY_FEEDER | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Optional WiaItemTypeFolder (ADF root item only, if WIA_CATEGORY_FEEDER_FRONT and WIA_CATEGORY_FEEDER_BACK items are present) |
| WIA_CATEGORY_FEEDER_BACK | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Optional None |
| WIA_CATEGORY_FEEDER_FRONT | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Optional None |
| WIA_CATEGORY_FILM | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder Optional None |
| WIA_CATEGORY_FINISHED_FILE | Required WiaItemTypeFile WiaItemTypeTransfer Optional WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted |
| WIA_CATEGORY_FLATBED | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Optional WiaItemTypeFolder (On the FB root item only if multiple scan regions items are supported) |
| WIA_CATEGORY_FOLDER | Required WiaItemTypeStorage WiaItemTypeFolder Optional WiaItemTypeDeleted |
| WIA_CATEGORY_IMPRINTER | WiaItemTypeProgrammableDataSource WiaItemTypeImage Optional WiaItemTypeTransfer WiaItemTypeFile |
| WIA_CATEGORY_MICR_READER | WiaItemTypeProgrammableDataSource Required WiaItemTypeTransfer WiaItemTypeFile |
| WIA_CATEGORY_PATCH_CODE_READER | WiaItemTypeProgrammableDataSource Required WiaItemTypeTransfer WiaItemTypeFile |
| WIA_CATEGORY_ROOT | Required WiaItemTypeRoot WiaItemTypeFolder Optional WiaItemTypeDevice WiaItemTypeDisconnected |
| WIA_CATEGORY_AUTO | Required WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Optional None |
The following table shows the WIA grouped categories and their WIA properties and WIA items.
| WIA category | WIA properties | WIA items |
|---|---|---|
| WIA_CATEGORY_FEEDER | Properties include those for feeder-scanner control. Image-specific and document-specific properties are typically included. |
WIA Feeder items, including child items that represent the front and back pages of a document. |
| WIA_CATEGORY_FEEDER_BACK | Properties include those for feeder-scanner control. Image-specific and document-specific properties are typically included. |
WIA Feeder item that represents the back page of a document. |
| WIA_CATEGORY_FEEDER_FRONT | Properties include those for feeder-scanner control. Image-specific and document-specific properties are typically included. |
WIA Feeder item that represents the front page of a document. |
| WIA_CATEGORY_FILM | Properties include those for film-scanner control. Image-specific and document-specific properties are typically included. |
WIA Film items, including child items that represent the individual scanning frames. However, child items can't have the WiaItemTypeFolder flag. |
| WIA_CATEGORY_FINISHED_FILE | Properties depend on the item type that is reported. For example, WiaItemTypeImage should have some image-item properties, such as bits per pixel. | WIA Storage items, including child items that represent finished file content (in other words, data files such as .jpg, .htm, and .txt files). |
| WIA_CATEGORY_FLATBED | Properties include those for flatbed-scanner control. Image-specific and document-specific properties are typically included. |
WIA Flatbed items, including child items that represent the regions that are being scanned on the scanner's flatbed platen. |
| WIA_CATEGORY_FOLDER | Properties include those for folder and device naming, access rights, document handling, and document status. | Items that represent storage units. For scanners with storage, they must have at least one folder scanner item. This item can have subfolder items that represent individual storage items. |
| WIA_CATEGORY_ROOT | Properties include those for device control, name, access rights, document handling, and device type. | The root item only. |
| WIA_CATEGORY_AUTO | Properties include those for auto-configured scanning. For more information, see WIA Properties Supported by an Auto Item | WIA auto item that represents the scanner's auto-configured scanning settings. |
Requirements
Header: wiadef.h (include Wiadef.h)
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for