Share via


IContentDirectory (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.