Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/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 IEventSourceclass.

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 IContentDirectoryImplclass, 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
Windows Mobile Windows Mobile Version 5.0 and later

See Also