Edit

Share via

WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT

  • Article

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, support 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, 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, 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 (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_BACK_REFERENCES Recommended if the object is referenced by another object.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID Optional.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Optional.
WPD_OBJECT_CAN_DELETE Required if the object cannot be deleted.
WPD_OBJECT_LANGUAGE_LOCALE 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 functions. A category is described by the WPD_FUNCTIONAL_OBJECT_CATEGORY property (a GUID value). The category determines which additional properties are supported.

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 valid only 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 the types of media files that 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.

 

Requirements for Objects