Edit

Device Properties (PortableDevice.h)

  • Article

Windows Portable Devices supports the following device properties.

Property VarType Description
WPD_DEVICE_DATETIME VT_DATE The current date and time on the device.
WPD_DEVICE_FIRMWARE_VERSION VT_LPWSTR The device's firmware version.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID VT_VECTOR | VT_UI1 A unique 16-byte identifier that is common across multiple transports supported by the device. If a single device supports multiple transports, this property may be used to associate the various transport WPD drivers with that device.
WPD_DEVICE_MANUFACTURER VT_LPWSTR A human-readable device manufacturer name.
WPD_DEVICE_MODEL VT_LPWSTR The device model.
WPD_DEVICE_MODEL_UNIQUE_ID VT_VECTOR | VT_UI1 A unique 16-byte identifier used to differentiate among different models of a device.
WPD_DEVICE_NETWORK_IDENTIFIER VT_UI8 A value that specifies the EUI-64 network identifier of the device; this property is used for out-of-band network operations.If the device has MAC-48 physical network addresses (typical of IPv4 networks), the MAC-48 address is encoded in the EUI-64 address as the two halves of the MAC-48 address separated by FF-FF. The EUI-64 value is stored in "network" or "big-endian" order, where an EUI-64 address of 01-02-03-FF-FF-04-05-06 would be placed in the VT_UI8 such that the decimal value is 72624942021346566. This property is required on any device that supports Nominal or Secure Authentication. This property is recommended on devices that support only Zero Authentication. The value can be used by the host to automatically establish access to the device without user intervention.
WPD_DEVICE_POWER_LEVEL VT_UI4 A value from 0 to 100 that specifies the power level of the device's battery, with 0 being none, and 100 being fully charged.
WPD_DEVICE_POWER_SOURCE VT_UI4 A WPD_POWER_SOURCES enumeration that specifies the power source of the device.
WPD_DEVICE_PROTOCOL VT_LPWSTR The device protocol that is being used.
WPD_DEVICE_SERIAL_NUMBER VT_LPWSTR The device's serial number.
WPD_DEVICE_SUPPORTED_DRM_SCHEMES VT_UNKNOWN A value that specifies whether the supported formats returned from the device are in a preferred order. The first format in the list is most preferred by the device, while the last is the least preferred.Applications may use this property to determine whether a device's supported formats are listed in a preferred order.
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED VT_BOOL A Boolean value that specifies whether the supported formats returned from the device are in a preferred order; that is, the first returned format is most preferred while the last returned format is least preferred.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE VT_BOOL A Boolean value that specifies whether the device supports non-consumable objects. These are objects that the device is only meant to store, not play or use in any way.
WPD_DEVICE_SYNC_PARTNER VT_LPWSTR A human-readable description of a device's synchronization partner. This is a device, application, or server that the device communicates with to maintain a common state or group of files between both partners. Examples include e-mail programs and music libraries.
WPD_DEVICE_FRIENDLY_NAME VT_LPWSTR A value that represents the friendly name set by the user on the device.
WPD_DEVICE_TRANSPORT VT_UI4 the transport supported by the device, such as USB, IP, or Bluetooth. Valid values are of the WPD_DEVICE_TRANSPORTS enumeration type.
WPD_DEVICE_TYPE VT_UI4 A value that specifies the device type; applications use this property for representation purposes only. Functional characteristics of the device are decided through functional objects.Devices that do not supply a device icon, for example, a WPD_RESOURCE_ICON for the device object, will be represented in the WPD Namespace with a generic icon. This icon will depend on the specified device type, for example, if the device type is a mobile phone, the generic phone icon is used. On first install of the device, the WPD Class Installer will query this property value and store it in the device registry under the PORTABLE_DEVICE_TYPE value as a REG_DWORD.
This parameter's possible values are from the WPD_DEVICE_TYPES enumeration defined in PortableDevice.h. Values are:
WPD_DEVICE_TYPE_GENERIC
WPD_DEVICE_TYPE_CAMERA
WPD_DEVICE_TYPE_MEDIA_PLAYER
WPD_DEVICE_TYPE_PHONE
WPD_DEVICE_TYPE_VIDEO
WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER
WPD_DEVICE_TYPE_AUDIO_RECORDER
WPD_DEVICE_USE_DEVICE_STAGE VT_BOOL If this property exists and is set to TRUE, the device can be used with Device Stage . This is meant for devices that cannot store metadata using the Device Metadata Service, but will provide metadata on the Microsoft servers.

Requirements

Requirement Value
Header
PortableDevice.h

See also

WPD Properties and Attributes