Device Properties (PortableDevice.h)
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_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 |
|