Edit

WIA_IPS_CUR_INTENT

  • Article

The WIA_IPS_CUR_INTENT property contains the current settings for an application's intended use of an image. The WIA minidriver creates and maintains this property.

Property Type: VT_I4

Valid Values: WIA_PROP_FLAG

Access Rights: Read/write

Remarks

A driver uses the intent settings to pre-set item properties based on an application's intended use of an image. These properties might include, for example, maximum quality and minimum size.

The following table contains the image-type flags and their definitions. These flags are used to set which type of image is intended: color, grayscale, and so on.

Image type flags Definition
WIA_INTENT_IMAGE_TYPE_COLOR The application intends to prepare the device for a color scan.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE The application intends to prepare the device for a grayscale scan.
WIA_INTENT_IMAGE_TYPE_TEXT The application intends to prepare the device for scanning text.
WIA_INTENT_IMAGE_TYPE_MASK This flag is a mask for all of the image-type flags.
WIA_INTENT_NONE Default value. No intent is specified.

The following table contains the image size and quality flags and their definitions. These flags are used to set the size and quality of an image scan.

Image size/quality Flags Definition
WIA_INTENT_BEST_PREVIEW The application intends to prepare the device for scanning a preview.
WIA_INTENT_MAXIMIZE_QUALITY The application intends to prepare the device for scanning a high-quality image.
WIA_INTENT_MINIMIZE_SIZE The application intends to prepare the device for scanning an image that results in a small scan.
WIA_INTENT_SIZE_MASK This flag is a mask for all of the size and quality flags.

The driver chooses the bit depth, in dots per inch, and other settings that it determines are appropriate for the selected intent. The application must read the current settings to determine which properties were changed.

An application sets the WIA_IPS_CUR_INTENT property to auto-set the WIA properties for specific acquisition intent. Note that flags can be combined with a bitwise OR operator, but an image cannot be both grayscale and color.

WIA_IPS_CUR_INTENT is required for all image acquisition enabled items; it is not available for storage items or stored image items.

Requirements

Header: wiadef.h (include Wiadef.h)