Share via

IConnectionManagerImpl (Windows Embedded CE 6.0)

  • Article

1/6/2010

This class derives from the pure virtual IConnectionManager class and provides implementations for all methods in IConnectionManager.

Syntax

class IConnectionManagerImpl : public IConnectionManager

Methods

The following table shows the methods for this interface. This class inherits methods defined in the IConnectionManager interface; the table does not show these inherited methods.

Method Description

IConnectionManagerImpl::AddSinkProtocol

Adds the specified protocol string to the sink protocol information for this ConnectionManager instance.

IConnectionManagerImpl::AddSourceProtocol

Adds the specified protocol string to the source protocol information for this ConnectionManager instance.

IConnectionManagerImpl::CreateConnection

Provides developers with a chance to perform custom connection-preparation tasks, including creating and returning references to IAVTransport and IRenderingControl instances.

IConnectionManagerImpl::EndConnection

Provides developers with a chance to perform custom connection-termination tasks.

IConnectionManagerImpl::RemoveSinkProtocol

Removes the specified protocol string from the sink protocol information for this ConnectionManager instance.

IConnectionManagerImpl::RemoveSourceProtocol

Removes the specified protocol string from the source protocol information for this ConnectionManager instance.

Remarks

Rather than deriving directly from the IConnectionManager class, devices can provide ConnectionManager functionality by inheriting from this class.

In contrast to the other similar implementation classes (like IAVTransportImpl), this class provides more than method overrides for optional methods. This class includes a connection and protocol management implementation that most devices can use; therefore, the devices do not need to provide their own connection and protocol management code.

Although the code in this class manages connections and protocol information, it does not have the inherent ability to create device-specific IAVTransport and IRenderingControl implementations. To use the management functionality in this class, custom code must provide implementations for IConnectionManagerImpl::CreateConnection and IConnectionManagerImpl::EndConnection.

Note

For information about the many of the methods implemented in this class, see its parent interface, IConnectionManager. The documentation for this interface only contains information about additional methods defined initially in this interface, like IConnectionManagerImpl::AddSinkProtocol.

The AVTransport service's PrepareForConnection action is defined as optional in the UPnP AV DCP. The AV renderer sample implements PrepareForConnection, or does not, depending on the value of the CM_NO_PREPARE_FOR_CONNECTION preprocessor definition. If this constant is defined, the sample does not support PrepareForConnection; otherwise, the sample provides support for multiple connections. To see how this definition is used, examine ConnectionManager.cpp in the AV renderer sample's source directory.

For more information about the ConnectionManager DCP, 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
IAVTransport
IAVTransportImpl
IConnectionManager
IConnectionManagerImpl::AddSinkProtocol
IConnectionManagerImpl::CreateConnection
IConnectionManagerImpl::EndConnection
IRenderingControl