Edit

WIA Properties Supported by an Auto Item

  • Article

An auto item represents the auto-configured scanning function of a WIA device that can automatically configure most of its settings for a scanning job without intervention by a WIA application. For more information about auto items, see the discussion of the WIA_CATEGORY_AUTO category in WIA Item Categories.

The WIA service manages the following WIA properties on an auto item:

WIA_IPA_ITEM_NAME

WIA_IPA_FULL_ITEM_NAME

WIA_IPA_ITEM_FLAGS

WIA_IPA_ACCESS_RIGHTS

WIA_IPA_COLOR_PROFILE

The WIA service initializes the WIA_IPA_ITEM_NAME property on behalf of the minidriver by setting the property value to the item name submitted by the minidriver. Similarly, the WIA service initializes the WIA_IPA_ITEM_FLAGS property on behalf of the minidriver by setting the property to the flags value submitted by the minidriver.

The WIA minidriver can implement the following properties on an auto item:

WIA_IPA_ITEM_CATEGORY

WIA_IPA_COMPRESSION

WIA_IPA_FILENAME_EXTENSION

WIA_IPA_FORMAT

WIA_IPA_PREFERRED_FORMAT

WIA_IPA_TYMED

For an auto item, the WIA architecture requires the minidriver to support all of the properties in the preceding list, except WIA_IPA_FILENAME_EXTENSION. Support for the WIA_IPA_FILENAME_EXTENSION property is optional, but recommended.

The minidriver must set the WIA_IPA_ITEM_CATEGORY property on an auto item to the value WIA_CATEGORY_AUTO. The last five properties in the preceding list enable a WIA application to negotiate the file format used to transfer image data that the device acquires during auto-configured scanning. The application should select a file format based on its internal requirements. Some applications might enable a user to select a file format from a list of formats that are supported by both the application and the driver.