IContentDirectory (Windows CE 5.0)
This pure virtual class contains methods that expose the functionality provided by the UPnP AV ContentDirectory service. MediaServer devices use the ContentDirectory service to expose the media they manage to control points. Control points use the ContentDirectory service to search for and obtain information, like media format, necessary to create a stream from a MediaServer device to a MediaRenderer device.
class IContentDirectory : public IEventSource
Methods
The following table shows the methods for this class. This class also inherits the methods from the IEventSource class.
| Method | Description |
|---|---|
| IContentDirectory::BrowseChildren | Returns DIDL-Lite XML that includes all of the first-level objects under the specified object and the metadata for all returned objects. |
| IContentDirectory::BrowseMetadata | Returns DIDL-Lite XML that contains the metadata for the specified object. |
| IContentDirectory::CreateObject | Creates a new object in the specified container. |
| IContentDirectory::CreateReference | Creates a new reference item that refers to the specified object. |
| IContentDirectory::DeleteResource | Deletes all res elements with the specified URI. |
| IContentDirectory::DestroyObject | Deletes the specified object. |
| IContentDirectory::ExportResource | Starts the transfer of a file from a local source to a remote destination, using HTTP. |
| IContentDirectory::GetSearchCapabilities | Returns the searching capabilities supported by this ContentDirectory instance. |
| IContentDirectory::GetSortCapabilities | Returns the sorting capabilities supported by this ContentDirectory instance. |
| IContentDirectory::GetSystemUpdateID | Returns the current value of the SystemUpdateID state variable. |
| IContentDirectory::GetTransferProgress | Returns status information about a resource transfer. |
| IContentDirectory::ImportResource | Starts the transfer of a file from a remote source to a local destination, using HTTP. |
| IContentDirectory::InvokeVendorAction | Enables ContentDirectory implementations and users to provide and invoke custom vendor-specific actions that are not defined in the ContentDirectory DCP. |
| IContentDirectory::Search | Searches for all objects that meet the specified search criteria. |
| IContentDirectory::StopTransferResource | Stops the specified resource transfer. |
| IContentDirectory::UpdateObject | Modifies, inserts, or deletes object metadata. |
Obtaining a Pointer
This class is used by UPnP MediaServer devices and control points.
UPnP MediaServer devices implement the methods in this class to make their device functionality and media library available to UPnP control points. Rather than deriving directly from this class, devices can inherit from the provided IContentDirectoryImpl class, which provides useful implementations for some of the methods in this class.
Control points use this class to control UPnP MediaServer devices. A control point obtains a pointer to this class by calling MediaServerDevice::GetContentDirectory.
Remarks
The methods in this class match the actions in the ContentDirectory service, with the exception of IContentDirectory::InvokeVendorAction, IContentDirectory::BrowseChildren, and IContentDirectory::BrowseMetadata (the latter two replace the single Browse action, which supports browsing both content and metadata).
For more information about the ConnectionManager service, see UPnP AV DCP Documentation.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Av_upnp.h.
Link Library: Av_upnp.lib.
C++ Namespace: av_upnp.
See Also
UPnP AV Interface and Implementation Classes | IContentDirectoryImpl | IEventSource | MediaServerDevice::GetContentDirectory
Send Feedback on this topic to the authors