IRenderingControl (Windows Embedded CE 6.0)

1/6/2010

This pure virtual class contains methods that expose the functionality provided by the UPnP AV RenderingControl service. The RenderingControl service is used by MediaRenderer devices to enable control points to access and change device settings that affect playback, like volume, video settings, and so on.

Syntax

class IRenderingControl : public IVirtualService, 
      public IEventSource

Methods

The following table shows the methods for this class. This class also inherits the methods from the IVirtualService and IEventSource classes.

Obtaining a Pointer

This class is used by UPnP MediaRenderer devices and control points.

UPnP MediaRenderer devices implement the methods in this class to make their device hardware and other functionality available to UPnP control points. Rather than deriving directly from this class, devices can inherit from the provided IRenderingControlImpl class, which provides useful implementations for some of the methods in this class.

Control points use this class to control UPnP MediaRenderer devices. A control point obtains a pointer to this class by:

1. Retrieving an IConnectionManager instance using MediaRendererDevice::GetConnectionManager.
2. Calling IConnectionManager::PrepareForConnection to retrieve, among other things, an IRenderingControl reference.

A control point can also retrieve a pointer to a class that implements this interface by calling IConnectionManager::GetCurrentConnectionInfo and then using the pRenderingControl field in the returned ConnectionInfo structure.

Remarks

The methods in this class match the actions in the RenderingControl service, with the exception of IRenderingControl::InvokeVendorAction.

For more information about the RenderingControl service, see UPnP AV DCP Documentation.

Requirements

See Also

Reference

UPnP AV Interface and Implementation Classes
ConnectionInfo
IConnectionManager
IConnectionManager::GetCurrentConnectionInfo
IConnectionManager::PrepareForConnection
IEventSource
IRenderingControlImpl
IVirtualService
MediaRendererDevice::GetConnectionManager