Device Information Property Constants

Device Information Properties are properties that describe the setup and installation of the device. These properties are available through the IWiaDevMgr or IWiaDevMgr2 interfaces and also through the root item. Device information properties are prefixed with "WIA_DIP_" (Device Information Property) and are supplied by Windows Image Acquisition (WIA). For scripting purposes, these constants use the prefix "DeviceInfo" and are part of the WiaDeviceInfoPropertyId 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_DIP_DEV_ID
DeviceInfoDevId
The device ID string for the WIA minidriver. The WIA service creates and maintains this property.
Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_DIP_VEND_DESC
DeviceInfoVendDesc
The vendor description string for the WIA minidriver. The vendor description is obtained from the INF file. An application reads this property to get a description of the device vendor. The WIA service creates and maintains this property.
Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_DIP_DEV_DESC
DeviceInfoDevDesc
The device description string for the WIA minidriver. The WIA service creates and maintains this property. The device description string this property contains is obtained from the INF file. An application reads this property to get a description of the device.
Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE
WIA_DIP_DEV_TYPE
DeviceInfoDevType
The device type and device subtype. The WIA service creates and maintains this property. Use the GET_STIDEVICE_TYPE macro to get the device type. The device type and subtype are obtained from the INF file. An application reads this property to determine whether it is using a scanner, camera, or video device.
Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE
Currently, device types are defined as follows. The asterisk * indicates that the device type is not supported by Windows Vista and later. The double asterisk ** indicates that the device type is not supported by either Windows Server 2003, Windows Vista, or later.
Type Value Definition
StiDeviceTypeDefault 0x0000 Default device
StiDeviceTypeScanner 0x0001 Scanner device (See the WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES to determine if the scanner is flatbed or sheet-fed.)
StiDeviceTypeDigitalCamera* 0x0002 Camera device
StiDeviceTypeStreamingVideo** 0x0003 Video device

 

WIA_DIP_PORT_NAME
DeviceInfoPortName

The installed device's port name, which is assigned by the kernel-mode driver that operates the device. The WIA service creates and maintains this property. An application reads this property to determine the port name.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_DEV_NAME
DeviceInfoDevName

The name of the device. The WIA service creates and maintains this property. The device name contained in this property is obtained from the INF file. An application reads this property to obtain the name of the device.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_SERVER_NAME
DeviceInfoServerName

The name of the server that the WIA minidriver is running on. This property is optional for Windows XP and later.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_REMOTE_DEV_ID
DeviceInfoRemoteDevId

The device ID of the WIA device that is installed on a remote computer. The WIA service creates and maintains this property. It is only used internally by the WIA service.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_UI_CLSID
DeviceInfoUIClsid

The vendor-supplied CLSID for any UI extension COM object that is installed with the WIA minidriver. The WIA service creates and maintains this property. The UI CLSID value contained in this property is obtained from the INF file. If no UI CLSID is specified, the WIA service supplies a default value. This property is only used internally by the WIA service when UI is being displayed.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_HW_CONFIG
DeviceInfoHwConfig

The type of connection that the device is using. The WIA service creates and maintains this property, and only the WIA service can change it.

Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE

The property can have the following possible values.

Value Definition
1 Generic WDM device
2 SCSI device
4 USB device
8 Serial device
16 Parallel device

 

WIA_DIP_BAUDRATE
DeviceInfoBaudRate

The current baud rate setting for the device. The WIA service creates and maintains this property. The value should be "Empty" if the device is not connected by a serial cable.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_STI_GEN_CAPABILITIES
DeviceInfoStiGenCapabilities

The generic STI capabilities for the device as obtained from the INF file. The WIA service creates and maintains this property. An application reads this property to determine the generic STI capabilities of the device.

Type: VT_I4, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_WIA_VERSION
DeviceInfoWiaVersion

The number (as a string) of the current WIA version that is installed on the system. An application reads this property to determine the version of WIA that is installed on the system. The WIA service creates and maintains this property. This property is available in Windows XP and later.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_DRIVER_VERSION
DeviceInfoDriverVersion

The current DLL version of the WIA minidriver. The WIA service creates and maintains this property. This property is available in Windows XP and later.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_PNP_ID
DeviceInfoPNPID

The current PnP id for the device. The WIA service creates and maintains this property. This property is available in Windows Vista and later.

Type: VT_BSTR, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_DIP_STI_DRIVER_VERSION
DeviceInfoStiDriverVersion

The generic STI driver version. The WIA service creates and maintains this property. An application reads this property to determine the generic STI driver version. This property is available in Windows Vista and later.

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