WIA_IPS_CUR_INTENT

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 flagsDefinition

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 FlagsDefinition

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)

 

 

Send comments about this topic to Microsoft

Show: