Reading and Setting WIA Properties

The IWiaPropertyStorage interface provides methods for reading and writing a Windows Image Acquisition (WIA) item's properties. Item properties include device commands, item format information, and device information.

An application can obtain a pointer to an IWiaPropertyStorage interface of an item either by enumerating the item's device information or event information by calling IWiaItem::EnumDeviceCapabilities or IWiaItem::EnumRegisterEventInfo or by querying the IWiaItem interface of the item. (In WIA 2.0, do this by calling IWiaItem2::EnumDeviceCapabilities or IWiaItem2::EnumRegisterEventInfo or by querying the IWiaItem2 interface of the item.)

IWiaPropertyStorage inherits from IPropertyStorage and the inherited methods are implemented as described in the reference section of Structured Storage in the Windows Software Development Kit (SDK).

Note

WIA applications should always read image data headers for accurate image information. The WIA driver can alter the WIA properties and image data headers during data transfer.

If there is no image data header supplied with the specified format, the WIA application should use the WIA properties as an information source about the data transfer. The WIA application should reread the needed WIA properties after the scan or capture completes to get the updated settings.

 

The following sections describe the various WIA properties:

• WIA Property Validation
• Device Information Properties
• Device Properties
• Item Properties
• Additional WIA Properties
• Defining Custom Properties
• Using Custom Properties
• Scan Profile Schema