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/valueDescription
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 StatusDefinition
WIA_DEVICE_NOT_CONNECTEDDevice is not connected.
WIA_DEVICE_CONNECTEDDevice 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

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wiadef.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft