Common Device Property Constants

In addition to device information properties, Windows Image Acquisition (WIA) devices have property values stored in the registry that applications read and write. They are associated with the IWiaItem object or IWiaItem2 object. Device properties represent device information such as connection status and device time. Each device property has an associated device property string.

The Device Property Constants listed here are common to most or all WIA hardware devices.

The prefix "WIA_DPA_" indicates a Device Property for All devices and is the naming convention used in C/C++. For scripting purposes these constants use the prefix "Device" 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_DPA_CONNECT_STATUS
DeviceConnectStatus
The current connection status for the device. The minidriver creates and maintains this property.
Type: VT_I4, Access: Read-only, Valid values: WIA_PROP_NONE
The property can have the following possible values.
Connect Status Definition
WIA_DEVICE_NOT_CONNECTED Device is not connected.
WIA_DEVICE_CONNECTED Device is connected and operational.

 

WIA_DPA_DEVICE_TIME
DeviceDeviceTime

The current clock time that is stored on the device. The minidriver creates and maintains this property.

Type: VT_UI2 | VT_VECTOR, Access: Read/Write or Read-only, Valid values: WIA_PROP_NONE

This property is supported only by devices that have an internal clock. If the device clock can be set, this property is Read/Write; otherwise, it is Read-only.

WIA devices report time in a SYSTEMTIME structure.

WIA_DPA_FIRMWARE_VERSION
DeviceFirmwareVersion

The device firmware version. This value must be a string value, such as "1.0.4" or "1.0abc". The minidriver creates and maintains this property. If the WIA minidriver does not supply a version resource, the WIA service supplies the value "0.0.0.0" as a default. An application reads this property to determine the version of the WIA minidriver DLL.

Type: VT_BSTR, Access: Read-only, Valid values: WIA_PROP_NONE

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Wiadef.h