WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT
.gif)
| Previous | Next |
WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT
An object that describes its type as WPD_CONTENT_FUNCTIONAL_OBJECT represents a functional object, encapsulating device functionality.
All functional objects, no matter what type, should host the following properties. (If you define a custom functional object, it must also support these properties.)
| Property Name | Required or Optional |
| WPD_OBJECT_ID | Required, but read-only; a client cannot set this property even at creation time. |
| WPD_OBJECT_PARENT_ID | Required |
| WPD_OBJECT_NAME | Required |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Required, but read-only; a client cannot set this property even at creation time. |
| WPD_OBJECT_FORMAT | Required |
| WPD_OBJECT_CONTENT_TYPE | Required |
| WPD_OBJECT_ISHIDDEN | Required if the object is hidden. |
| WPD_OBJECT_ISSYSTEM | Required if the object is a system object (that is, it represents a system file). |
| WPD_OBJECT_SIZE | Required if the object has at least one resource. |
| WPD_OBJECT_ORIGINAL_FILE_NAME | Required if the object represents a file. |
| WPD_OBJECT_NON_CONSUMABLE | Recommended if the object is not meant for consumption by the device. |
| WPD_OBJECT_REFERENCES | Required if the object has references to other objects. |
| WPD_OBJECT_KEYWORDS | Optional |
| WPD_OBJECT_SYNC_ID | Optional |
| WPD_OBJECT_IS_DRM_PROTECTED | Required if the object is protected by DRM technology. |
| WPD_OBJECT_DATE_CREATED | Optional |
| WPD_OBJECT_DATE_MODIFIED | Recommended |
| WPD_OBJECT_DATE_AUTHORED | Optional |
| WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID | Optional |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Optional |
| WPD_FUNCTIONAL_OBJECT_CATEGORY | Required (see the following table for categories defined by Windows Portable Devices) |
Typical Resources
These objects typically do not host resources.
Functional object categories
Functional objects can be grouped into categories, depending on their function. A functional object supports additional properties depending on what category it falls in. A functional object's category is described by its WPD_FUNCTIONAL_OBJECT_CATEGORY property (a GUID value).
The following table describes the categories defined by Windows Portable Devices. See the description of the category to learn what additional properties and resources the object supports.
| Functional category | Description |
| WPD_FUNCTIONAL_CATEGORY_ALL | This functional category is only valid as a parameter for certain query functions (to indicate that all functional object types are acceptable), and is not a reported functional category by the driver. |
| WPD_FUNCTIONAL_CATEGORY_AUDIO_CAPTURE | The object encapsulates audio capture functionality on the device (for example, a voice recorder or other audio recording component). |
| WPD_FUNCTIONAL_CATEGORY_DEVICE | The object encapsulates the device (that is, the top-most object of the device). |
| WPD_FUNCTIONAL_CATEGORY_NETWORK_CONFIGURATION | The object encapsulates network-configuration functionality for the device (for example, WiFi profiles or partnerships). |
| WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION | The object describes what kind of media files the device is able to play. |
| WPD_FUNCTIONAL_CATEGORY_SMS | The object encapsulates short message service functionality (commonly called "text messaging") on the device. |
| WPD_FUNCTIONAL_CATEGORY_STILL_IMAGE_CAPTURE | The object encapsulates still image capture functionality on a device such as a camera or camera attachment. |
| WPD_FUNCTIONAL_CATEGORY_STORAGE | The object encapsulates physical file storage on the device. |
| WPD_FUNCTIONAL_CATEGORY_VIDEO_CAPTURE | The object encapsulates video capture functionality on the device (for example, a video recorder component). An application uses this object to gain programmatic control. |
See Also
| Previous | Next |