Device Object
The device object must support the following properties. An application can request these properties by querying the root object (specifying the defined WPD_DEVICE_OBJECT_ID constant object ID). All values of the device object are read-only.
| Property Name | Required or Optional |
|---|---|
| WPD_OBJECT_ID | Required. The value is WPD_DEVICE_OBJECT_ID. |
| WPD_OBJECT_PARENT_ID | Required value is an empty string. |
| WPD_OBJECT_NAME | Required if the object represents a file. |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Required. |
| WPD_OBJECT_ISHIDDEN | Required if the device object should not be shown to the user. |
| WPD_OBJECT_REFERENCES | Required if the object has references to other objects. |
| WPD_OBJECT_KEYWORDS | Optional. |
| WPD_OBJECT_SYNC_ID | Optional. |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Optional. |
| WPD_DEVICE_SYNC_PARTNER | Optional. |
| WPD_DEVICE_FIRMWARE_VERSION | Required |
| WPD_DEVICE_POWER_LEVEL | Required if the device has a battery. |
| WPD_DEVICE_POWER_SOURCE | Required. |
| WPD_DEVICE_PROTOCOL | Optional. |
| WPD_DEVICE_MANUFACTURER | Required. |
| WPD_DEVICE_MODEL | Required. |
| WPD_DEVICE_SERIAL_NUMBER | Required. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | Required if the device supports non-consumable objects; that is, if it can be used for simple data storage. |
| WPD_DEVICE_DATETIME | Optional. |
Typical Resources
These objects typically do not host resources.
Commands
In addition to properties, devices should support a specific set of commands defined by Windows Portable Devices. What commands an object or device supports depends on its type, functionality, and capabilities.
The following table describes the command classes that apply to devices, by functionality. Typically, a device falls under several categories, and it should support the commands for all applicable categories. For example, a mobile phone with a camera would fall under three categories: all devices, SMS devices, and still image capture devices. A custom driver and client application can support additional commands or properties that you define, but must support the following commands. For a description of the specific commands that fall under each command category, see Commands.
| Command categories | Description |
|---|---|
| WPD_CATEGORY_CAPABILITIES
WPD_CATEGORY_COMMON WPD_CATEGORY_OBJECT_ENUMERATION WPD_CATEGORY_OBJECT_MANAGEMENT WPD_CATEGORY_OBJECT_PROPERTIES WPD_CATEGORY_OBJECT_PROPERTIES_BULK WPD_CATEGORY_OBJECT_RESOURCES |
All devices. |
| WPD_CATEGORY_STILL_IMAGE_CAPTURE | Devices that can capture still images, such as digital cameras. |
| WPD_CATEGORY_SMS | Devices that can send short message service (SMS) messages, such as cellular phones. Sending SMS messages is also called "text messaging". |
| WPD_CATEGORY_STORAGE | Devices that function as storage devices. These include external drives.
If a device supports the ability to format a store or to move objects from one location to another, your driver should support this category. |
Related topics