Device Properties
.gif)
| Previous | Next |
Device Properties
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_MANUFACTURER | VT_LPWSTR | A human-readable device manufacturer name. |
| WPD_DEVICE_MODEL | VT_LPWSTR | The device model. |
| 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 will be 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_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 will be 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 |
Requirements
Header: Defined in PortableDevice.h
See Also
| Previous | Next |