IContentDirectory (Windows Embedded CE 6.0)

1/6/2010

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.

Syntax

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

Header	av_upnp.h
Library	Av_upnp.lib
Windows Embedded CE	Windows CE 5.0 and later

See Also

Reference

UPnP AV Interface and Implementation Classes
IContentDirectoryImpl
IEventSource
MediaServerDevice::GetContentDirectory