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, 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.

 

Related topics

Requirements for Objects