Common WIA Item Property Constants

The following device property constants must be supported by all IWiaItem, IWiaItem2 and IWiaDrvItem Interface interfaces unless otherwise noted in their descriptions.

The prefix "WIA_IPA_" indicates an item property for all devices and is the naming convention used in C/C++. For scripting purposes these constants use the prefix "Picture" 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
WIA_IPA_ACCESS_RIGHTS PictureAccessRights	This flag controls access to the item as well as whether the item is deleted. Required for all WIA 2.0 items. Type: VT_I4; Read/Write or Read Only, depending on the item's ability to have its access rights changed; Valid values: WIA_PROP_FLAG The following table has the five flags that are valid with this property. Access Right Description WIA_ITEM_READ Item has read-only access. WIA_ITEM_WRITE Item has write-only access. WIA_ITEM_CAN_BE_DELETED Item has delete-only access. WIA_ITEM_RD WIA_ITEM_READ | WIA_ITEM_CAN_BE_DELETED WIA_ITEM_RWD WIA_ITEM_READ | WIA_ITEM_WRITE | WIA_ITEM_CAN_BE_DELETED
WIA_IPA_APP_COLOR_MAPPING PictureAppColorMapping	This property is reserved by for future use and is not implemented at this time. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_BITS_PER_CHANNEL PictureBitsPerChannel	Contains the number of bits per channel for the image. The minidriver creates and maintains this property. Required for all WIA 2.0 acquisition-enabled or stored image items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_BUFFER_SIZE PictureBufferSize	Contains the size of the buffer, in bytes, used during a data transfer. The minidriver creates and maintains this property. An application can read this property to determine the driver-specified buffer size for data transfers. The WIA service also reads this property to allocate memory for the minidriver during the data transfer Optional for all transfer-enabled WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE Note: The WIA_IPA_BUFFER_SIZE property contains is the minimum amount of data an application can request at any given time. The larger the buffer size, the larger the requests to the device will be. This can make the device seem slow and unresponsive, can slow the overall system performance, and can consume excessive resources. Buffer sizes that are too small can slow performance of the data transfer by requiring many smaller requests. Choose a reasonable buffer size by considering the typical size of a data request to your device and balancing the number of requests against the size of those requests.
WIA_IPA_BYTES_PER_LINE PictureBytesPerLine	Contains the number of bytes in one scan line of the image. The minidriver creates and maintains this property. Optional for all WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_CHANNELS_PER_PIXEL PictureChannelsPerPixel	Contains the number of channels per pixel for the image. The minidriver creates and maintains this property. Required for all WIA 2.0 acquisition-enabled or stored image items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_COLOR_PROFILE PictureColorProfile	This property is reserved by for future use and is not implemented at this time. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_COMPRESSION PictureCompression	Contains the current compression type used. The minidriver creates and maintains this property. An application reads this property to determine the image compression type or sets this property to configure the compression setting. Type: VT_I4, Access: Read/Write, Valid Values: WIA_PROP_LIST The following table has the constants that are valid with this property. The V symbol indicates that the constant is supported only in Windows Vista and later. (It is only available through the IWiaItem2 interface.) Compression Type Description WIA_COMPRESSION_NONE No compression. See Note for more information. WIA_COMPRESSION_AUTO Automatic compression mode. See Note for more information. WIA_COMPRESSION_BI_RLE4 RLE4 compression WIA_COMPRESSION_BI_RLE8 RLE8 compression WIA_COMPRESSION_G3 Group 3 compression WIA_COMPRESSION_G4 Group 4 compression WIA_COMPRESSION_JPEG JPEG compression. WIA_COMPRESSION_JBIGV JBIG compression. WIA_COMPRESSION_JPEG2KV JPEG 2000 compression. WIA_COMPRESSION_PNGV PNG compression.   [!Note] When this property is WIA_COMPRESSION_NONE, and WIA_IPA_FORMAT is either WiaImgFmt_PDFA or WiaImgFmt_XPS; then WIA_COMPRESSION_NONE means that the compression mode is undefined and the scanner must decide on a mode. WIA_COMPRESSION_AUTO is a new property value defined for the WIA_IPA_COMPRESSION property. This value is valid for all programmable image data source items, including the Flatbed and Feeder. When this value is supported by the WIA mini-driver, the WIA application client can set WIA_IPA_COMPRESSION in order to enable automatic compression mode detection at the device. WIA_COMPRESSION_AUTO can work with and without full auto-color being supported or enabled (WIA_DATA_AUTO and WIA_DEPTH_AUTO). WIA_COMPRESSION_AUTO is most useful with transfer file formats that support multiple data types and bit depths, such as WiaImgFmt_RAW. For more information about transfer file formats, see WIA_IPA_FORMAT in this table. It is opitonal for the WIA mini-driver to suport WIA_COMPRESSION_AUTO. When it is supported, the WIA mini-driver must never set it as the default value for WIA_IPA_COMPRESSION; only the WIA application can set this value.
WIA_IPA_DATATYPE PictureDatatype	Contains the current data type setting for the device. The minidriver creates and maintains this property. An application reads this property to determine the data type of the image. An application writes this property to set the current data type of the image about to be transferred. This property is required for all WIA 2.0 items. It must be Read/Write for all WIA 2.0 acquisition enabled items and Read Only for WIA 2.0 storage items. Type: VT_I4; Access for pre-Windows Vista operating systems: This property is Read Only for cameras and Read/Write for scanners; Access for Windows Vista and later: This property is Read Only for WIA_CATEGORY_FOLDER and WIA_CATEGORY_FINISHED_FILE items, and Read/Write for all other WIA 2.0 item categories; Valid Values: WIA_PROP_LIST The following table has the six constants that are valid with when WIA_IPA_FORMAT is not set to WiaImgFmt_RAW. Data Type Description WIA_DATA_AUTO Valid for all programmable image data source items, including the Flatbed and Feeder. When this value is supported by the WIA mini-driver, the WIA application client can set WIA_IPA_DATATYPE in order to enable automatic color detection at the device. When WIA_DATA_AUTO is set, the WIA mini-driver must update WIA_IPA_DEPTH on the same item to WIA_DEPTH_AUTO (which must be a supported value if the device supports automatic color). This is an optional value, but it is required when WIA_DEPTH_AUTO is supported for WIA_IPA_DEPTH. WIA_DATA_COLOR Scan data is red, green, blue (RGB) color. The full color format is described using the following WIA properties: WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PLANAR WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES WIA_DATA_COLOR_DITHER Same as WIA_DATA_COLOR except that the data is dithered using the currently selected dither pattern. WIA_DATA_COLOR_THRESHOLD Same as WIA_DATA_COLOR except that the threshold value is used when scanning the data. Color values over the WIA_IPS_THRESHOLD value are converted to full brightness; colors under this value are converted to black. WIA_DATA_DITHER Scan data is dithered using the currently selected dither pattern. WIA_DATA_GRAYSCALE Scan data represents intensity. The palette is a fixed, equally-spaced gray scale with a depth specified by WIA_IPA_DEPTH property. WIA_DATA_THRESHOLD The threshold is one bit per pixel of black-and-white data. Data over the current value of WIA_IPS_THRESHOLD is converted to white; data under this value is converted to black.   The WIA_IPA_DATATYPE property is also used to describe the type of RAW data transfer to be used when the application sets WiaImgFmt_RAW. The driver should set the WIA_IPA_DATATYPE property to a list of allowed values from which the application can pick one. If the device can be set to only a single value, create a WIA_PROP_LIST type, and place the valid value in it. Check the WIA_IPA_DEPTH property to determine the bit depth. This property usually contains a single value for cameras. The following table lists the constants that are valid with WIA_IPA_DATATYPE when WIA_IPA_FORMAT is set to WiaImgFmt_RAW. Data Type Description WIA_DATA_GRAYSCALE Scan data represents intensity. The palette is a fixed, equally spaced grayscale with a depth specified by the WIA_IPA_DEPTH property. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 1. WIA_DATA_RAW_BGR Scan data is in the BGR (blue-green-red) colorspace. The full color format is described using the followingWIAproperties: WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 3. WIA_DATA_RAW_CMY Scan data is in the cyan-magenta-yellow (CMY) colorspace. The full color format is described using the same WIA properties as in WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 3. WIA_DATA_RAW_CMYK Scan data is in the cyan-magenta-yellow-black (CMYK) colorspace. The full color format is described using the same WIA properties as in WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 4. WIA_DATA_RAW_RGB Scan data is in the red-green-blue (RGB) colorspace. The full color format is described using the same WIA properties as in WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 3. WIA_DATA_RAW_YUV Scan data is in the luminance-blue difference-red difference (YUV) colorspace. The full color format is described using the same WIA properties as in WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 3. WIA_DATA_RAW_YUVK Scan data is in the luminance-blue difference-red difference-black (YUVK) colorspace. The full color format is described using the same WIA properties as in WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL must be set to 4.
WIA_IPA_DEPTH PictureDepth	WIA_IPA_DEPTH Contains the bit depth setting of an image. The minidriver creates and maintains this property.An application reads this property to determine the bit depth setting of the image. The application might also be able to set this value to the desired bit depth. If the device can be set to only a single value, create a WIA_PROP_LIST type and place the valid value in it. This property is required for all WIA 2.0 items. It must be Read/Write for all WIA 2.0 acquisition enabled items and Read Only for WIA 2.0 storage items. Type: VT_I4; Access for pre-Windows Vista operating systems: Read/Write; Access for Windows Vista and later: This property is Read Only for WIA_CATEGORY_FOLDER and WIA_CATEGORY_FINISHED_FILE items, and Read/Write for all other WIA 2.0 item categories; Valid Values: WIA_PROP_LIST WIA_DEPTH_AUTO is defined as 0 bits per pixel, and it is a new property value defined for the WIA_IPA_DEPTH. This value is valid for all programmable image data source items, including the Flatbed and Feeder. When WIA_DEPTH_AUTO is supported by the WIA mini-driver, the WIA application client can set WIA_IPA_DEPTH to this value, to enable automatic color detection at the device. When WIA_DEPTH_AUTO is set, the WIA mini-driver must update WIA_IPA_DATATYPE on the same item to WIA_DATA_AUTO (which must be a supported value, if the device supports automatic color). WIA_DEPTH_AUTO is an optional value, but it becomes required when WIA_DATA_AUTO is supported for WIA_IPA_DATATYPE.
WIA_IPA_FILENAME_EXTENSION PictureFilenameExtension	Contains the file name extension for a particular file format. The minidriver creates and maintains this property. Optional for all transfer-enabled WIA 2.0 items. Type: VT_BSTR, Access: Read Only, Valid Values: WIA_PROP_NONE The driver updates this property to reflect the current value of the WIA_IPA_FORMAT property. For example, if WIA_IPA_FORMAT is WiaImgFmt_JPEG, then WIA_IPA_FILENAME_EXTENSION should be jpg. If WIA_IPA_FORMAT is WiaImgFmt_BMP, then WIA_IPA_FILENAME_EXTENSION should be BMP. Note: The file name extension does not include the dot.   This property is recommended for drivers that support standard formats and is required for drivers that implement custom-defined formats. It informs the application of the correct file name extension to use during the transfer of privately formatted files. For example, if the A. Datum Corporation created a WIA driver that transferred a file in a new format, the company could specify an extension of "adc". This allows applications to transfer data in that format to a file and to create a file name such as myfile.adc,which is useful to others who understand the new extension.
WIA_IPA_FORMAT PictureFormat	Contains the current format of the image about to be transferred. An application reads this property to determine the format of the image that it is about to receive. An application writes this property to set the format. This property depends on the WIA_IPA_TYMED property. The minidriver creates and maintains this property. If the device can be set to only a single value, create a WIA_PROP_LIST type, and place the valid value in it. Type: CLSID, Access: Read/Write, Valid Values: WIA_PROP_LIST The following table lists the constants that are valid with this property. The asterisk * indicates that the constant is not supported in Windows Vista. (It is only available through the IWiaItem interface.) The double asterisk ** indicates that the constant is not supported in either Windows Server 2003 or Windows Vista. The V symbol indicates that the constant is supported only in Windows Vista and later. (It is only available through the IWiaItem2 interface.) Format Description WiaAudFmt_AIFF AIFF audio format WiaAudFmt_MP3 MP3 audio format WiaAudFmt_WAV WAV audio format WiaAudFmt_WMA WMA audio format WiaImgFmt_ASF** ASF video format WiaImgFmt_AVI** AVI video format WiaImgFmt_BMP Windows bitmap with a header file WiaImgFmt_CIFF* Camera Image File format WiaImgFmt_DPOF DPOF printing format WiaImgFmt_EMF Extended Windows metafile WiaImgFmt_EXEC Executable file WiaImgFmt_EXIF Exchangeable File Format WiaImgFmt_FLASHPIX FlashPix format WiaImgFmt_GIF GIF image format WiaImgFmt_HTML HTML format WiaImgFmt_ICO Windows icon file format WiaImgFmt_JBIGV The Joint Bi-level Image Experts Group (JBIG) format. WiaImgFmt_JPEG JPEG compressed format WiaImgFmt_JPEG2K JPEG 2000 compressed format WiaImgFmt_JPEG2KX JPEG 2000 compressed format WiaImgFmt_MEMORYBMP Windows bitmap without a header file WiaImgFmt_PDFAV The PDF/A (ISO/CD 19005-1) format. WiaImgFmt_MPG** MPEG video format WiaImgFmt_PHOTOCD Eastman Kodak file format WiaImgFmt_PICT Apple file format WiaImgFmt_PNG W3C PNG format WiaImgFmt_RAW Raw format for data transfers only WiaImgFmt_RAWRGB Raw RGB format WiaImgFmt_RTF Rich Text File format WiaImgFmt_SCRIPT Script file WiaImgFmt_TIFF Tag Image File Format WiaImgFmt_TXT Text file WiaImgFmt_UNICODE16 UNICODE 16-bit encoding WiaImgFmt_WMF Windows metafile WiaImgFmt_XML XML file WiaImgFmt_XPSV XPS Package format   Note: When this property is either WiaImgFmt_PDFA or WiaImgFmt_XPS, and WIA_IPA_COMPRESSION is WIA_COMPRESSION_NONE; then the latter value means that the compression mode is undefined and the scanner must decide on a mode.
WIA_IPA_FULL_ITEM_NAME PictureFullItemName	Contains the full item name (the item name together with path information). The full item name is the same as the bstrFullItemName parameter of the wiasCreateDrvItem service utility function. An application reads this property to determine which item it is currently using and where that item is located in the item tree. Each item should have a unique name. Applications commonly use the full item name to search for items in the item tree. The WIA service creates and maintains this property. Required for all WIA 2.0 items. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_IPA_GAMMA_CURVES PictureGammaCurves	This property is reserved for future use and is not implemented at this time. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_ICM_PROFILE_NAME PictureIcmProfileName	Contains the ICM profile name that is needed to properly decode the image. An application reads this property to determine the ICM profile to use when processing the image. The WIA service creates and maintains this property based on the ICMProfiles entry in the driver installation file. Type: VT_BSTR, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_ITEM_CATEGORY PictureItemCategory	Supported only in Windows Vista and later. WIA 2.0 items are grouped into categories that define how a IWiaItem2 is to be treated or used. For example, If the item represents a feeder, then the application should expect it to contain the required document feeder properties and operate like a document feeder. If the item represents a finished file, then a WIA 2.0 application should treat it that way, assuming that the data is static and located on the device. (The rules for each item will be defined in their individual specification documents.) Required for all WIA 2.0 items. Type: VT_CLSID, Access: Read Only, Valid values: Item Category GUIDs
WIA_IPA_ITEM_FLAGS PictureItemFlags	Contains the descriptive flags for a WIA item. The item flags are the same as those in the lObjectFlags parameter of the wiasCreateDrvItem service utility function. The WIA service creates and maintains this property. An application reads this property to determine the item's descriptive flag values. Type: VT_I4 Access: Read Only, Valid values: WIA_PROP_NONE The following table has the flags that are valid with this property. An asterisk * indicates that the flag is not supported in Windows Vista or later. (It is only available through the IWiaItem interface.) An double asterisk ** indicates that the flag is not supported in either Windows Server 2003 or Windows Vista or later. The V symbol indicates that the flag is supported only in Windows Vista and later. (It is only available through the IWiaItem2 interface.) Flag Definition WiaItemTypeAnalyze* This item supports the IWiaItem::AnalyzeItem method (described in the Platform SDK documentation). This item also supports automatic child item generation. This capability is useful for region detection or page decomposition. WiaItemTypeAudio This item supports audio. This flag is valid only for items that also have the WiaItemTypeFile flag set. WiaItemTypeBurst* For folders only. This flag indicates that the images in this folder were taken in a continuous time sequence. WiaItemTypeDeleted This item is marked for deletion, this item has been deleted, this item does not exist, or the contents of this item are invalid. WiaItemTypeDocumentV This item is a document file in one of the document formats that the WIA_IPA_FORMAT property contains. (These formats include those for nonimage files, such as .txt, .htm, and .doc files.) WiaItemTypeDevice This item represents a connected device. WiaItemTypeDisconnected This item represents a disconnected device. WiaItemTypeFile The item supports file transfers. WiaItemTypeFolder The item is a folder. WiaItemTypeFree The item is uninitialized or has been deleted. WiaItemTypeGenerated This item has been generated by an application or by the driver. WiaItemTypeHasAttachments* This item supports attachments and currently contains attachments. WiaItemTypeHPanorama* This item represents a horizontal panoramic image. This flag is valid only for items that also have the WiaItemTypeFolder flag set. WiaItemTypeImage The item is an image file. This flag is valid only for items that also have the WiaItemTypeFile flag set. WiaItemTypeProgrammableDataSourceV The item is a programmable data source and follows a set of predefined configuration rules, which are based on WIA_IPA_ITEM_CATEGORY. WiaItemTypeRootV This item is the root item, which is the parent to all the feature items that the device supports. WiaItemTypeStorage This flag indicates additional storage for folders items. WIA drivers specify their items in terms of images and folders. No WIA properties exist that describe the characteristics of a storage item (such as remaining storage space, write speed, or type of media. Vendor-specific properties that expose this information can be added. These properties are accessible only to applications or extensions that are written to recognize them. WiaItemTypeTransfer This item can be used to transfer data. WiaItemTypeTwainCapabilityPassThrough This type indicates that the WIA device is able to receive TWAIN capability data from the TWAIN compatibility layer. If this type is set, any TWAIN capability that is not understood by the TWAIN compatibility layer will be passed to theWIA driver. This is valid only for the root item. WiaItemTypeVideo** This item supports streaming video. WiaItemTypeVPanorama* This item represents a vertical panoramic image. This flag is valid only for items that also have the WiaItemTypeFolder flag set.   Some of these flags are required or optional for WIA 2.0 items, according to the category of the item, as shown in this table. Category of Item Required Optional WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (If multiple scan regions items are supported, this flag is optional only for the WIA_CATEGORY_FLATBED root item.) WIA_CATEGORY_FEEDER WIA_CATEGORY_FEEDER_FRONT WIA_CATEGORY_FEEDER_BACK WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (If WIA_CATEGORY_FEEDER_FRONT and WIA_CATEGORY_FEEDER_BACK items are present, then this flag is optional only for the WIA_CATEGORY_FEEDER root item.) WIA_CATEGORY_FILM (root) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder None WIA_CATEGORY_FILM (children) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile None WIA_CATEGORY_FOLDER WiaItemTypeStorage WiaItemTypeFolder WiaItemTypeDeleted WIA_CATEGORY_FINISHED_FILE WiaItemTypeFile WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted
WIA_IPA_ITEM_NAME PictureItemName	Contains the item name. An application reads this property to determine which item it is currently using. Each item has a unique name. The WIA service creates and maintains this property. Required for all WIA 2.0 items. Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_IPA_ITEM_SIZE PictureItemSize	Contains the current size, in bytes, of the data that is associated with the item. The minidriver creates and maintains this property. Contains is the total size of the data being transferred. If this value is zero, it means that the minidriver has no information about the exact size of the data. (This is common for compressed data.) An application reads this value to determine the size of the acquisition before it takes place. The WIA service reads this property to assist in allocating memory for data transfers. For further information, see Transferring Data to a WIA Application if the property is set to zero and TYMED is configured for a file transfer, the WIA service does not allocate any memory for the WIA minidriver. Required for all transfer-enabled WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_ITEM_TIME PictureItemTime	Contains the time that the image was originally captured. The minidriver creates and maintains this property. This property should be reported as a vector of eight WORD values in the form of a SYSTEMTIME structure (described in the Platform SDK documentation). Optional for all WIA 2.0 items. Type: VT_UI2 | VT_VECTOR Access: Read/Write or Read Only, Valid values: WIA_PROP_NONE
WIA_IPA_ITEMS_STORED PictureItemItemsStored	Supported only in Windows Vista and later. Specifies how many items are stored in the WIA_CATEGORY_FOLDER item. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_NONE
WIA_IPA_MIN_BUFFER_SIZE PictureMinBufferSize	Specifies the minimum buffer size that is used in data transfers. If the data transfer is performed through a callback mechanism, the property value can be as small as 64KB. However, if the transfer is to file, the property value is the number of bytes that are needed to transfer one page of data at a time. The minidriver creates and maintains this WIA property. Optional for all transfer-enabled WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_NUMBER_OF_LINES PictureNumberOfLines	Contains the number of lines contained in the image (the vertical height of the image in pixels). The minidriver creates and maintains this property. Optional for all WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_PIXELS_PER_LINE PicturePixelsPerLine	Contains the number of pixels in each line of the image (the width of the image in pixels). The minidriver creates and maintains this property. Optional for all WIA 2.0 items. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_PLANAR PicturePlanar	This property is not supported in Windows Vista and later. Contains image data packing options. The minidriver creates and maintains this property. An application reads this property to determine the image packing options or sets the current image packing options. Type: VT_I4; Access: Read/Write; Valid Values: WIA_PROP_LIST. If the device can be set to only a single value, create a WIA_PROP_LIST type and place the valid value in it. The following table has the two constants that are valid with this property. Value Definition WIA_PACKED_PIXEL Image data is in packed-pixel format. WIA_PLANAR Image data is in planar format.
WIA_IPA_PREFERRED_FORMAT PicturePreferredFormat	Contains the preferred format for images that this minidriver transfers. The minidriver creates and maintains this property. Required for all transfer-enabled WIA 2.0 items. Type: CLSID, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_PROP_STREAM_COMPAT_ID PicturePropStreamCompatId	Specifies a CLSID that represents a set of device property values. If a device driver implements this feature, applications use this property to determine if the device supports a set of values. Type: CLSID, Access: Read Only, Valid Values: WIA_PROP_LIST The following table has the 12 constants that are valid with this property. Value Definition WiaImgFmt_BMP MicrosoftWindows bitmap with a header file WiaImgFmt_EMF Extended Windows metafile WiaImgFmt_EXIF Exchangeable File Format WiaImgFmt_FLASHPIX FlashPix format WiaImgFmt_GIF GIF image format WiaImgFmt_ICO Windows icon file format WiaImgFmt_JPEG JPEG compressed format WiaImgFmt_PHOTOCD Eastman Kodak file format WiaImgFmt_PNG W3C PNG format WiaImgFmt_MEMORYBMP Windows bitmap without a header file WiaImgFmt_TIFF Tag Image File Format WiaImgFmt_WMF Windows metafile
WIA_IPA_RAW_BITS_PER_CHANNEL PictureRawBitsPerChannel	Supported only in Windows Vista and later. Contains the number of bits in each channel. This property should be reported as a vector of as many BYTE values as there are channels, where the first BYTE corresponds to the number of bits in the first channel, the second byte to the number of bits in the second channel and so on. There need to be as many entries as there are channels according to WIA_IPA_CHANNELS_PER_PIXEL. The driver sets that property when the application switches to WiaImgFmt_RAW. For the well-known subtypes, there are as many entries as listed in the table under WIA_IPA_RAW_SUBTYPE. Type: VT_UI1|VT_VECTOR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_IPA_REGION_TYPE PictureRegionType	This property is reserved by for future use and is not implemented at this time. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE
WIA_IPA_SUPPRESS_PROPERTY_PAGE PictureSuppressPropertyPage	Specifies whether to suppress the general property pages for items on the device. This property is available on Windows XP and later. Type: VT_I4, Access: Read Only, Valid Values: WIA_PROP_NONE The following table has the constants that are valid with this property. The asterisk * indicates that the constant is not valid with Windows Vista and later. (It is only available through the IWiaItem interface.) Constant Description WIA_PROPPAGE_CAMERA_ITEM_GENERAL* Suppress the general item property page for a camera. WIA_PROPPAGE_SCANNER_ITEM_GENERAL Suppress the general item property page for a scanner.
WIA_IPA_TYMED PictureTymed	This property contains the transfer method setting. The minidriver creates and maintains this property. An application reads this property to determine the minidriver's method of data transfer. Required for all transfer-enabled WIA 2.0 items. Type: VT_I4, Access: Read/Write, Valid Values: WIA_PROP_LIST The following table has the constants that are valid with this property. The asterisk * indicates constants that are not valid with Windows Vista and later. (They are only available through the IWiaItem interface.) Transfer Type Description TYMED_CALLBACK* Transfer an image to memory, in bands. TYMED_MULTIPAGE_CALLBACK* Transfer multiple images to memory, in bands. TYMED_FILE Transfer an image to a file. TYMED_MULTIPAGE_FILE Transfer an image to a file.
WIA_IPA_UPLOAD_ITEM_SIZE PictureItemUploadItemSize	Supported only in Windows Vista and later. Specifies the number of bytes to upload for an item. Type: VT_I4, Access: Read/Write, Valid values: WIA_PROP_NONE

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Wiadef.h