IConnectionManagerImpl (Windows Embedded CE 6.0)
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 |
|---|---|
Adds the specified protocol string to the sink protocol information for this ConnectionManager instance. |
|
Adds the specified protocol string to the source protocol information for this ConnectionManager instance. |
|
Provides developers with a chance to perform custom connection-preparation tasks, including creating and returning references to IAVTransport and IRenderingControl instances. |
|
Provides developers with a chance to perform custom connection-termination tasks. |
|
Removes the specified protocol string from the sink protocol information for this ConnectionManager instance. |
|
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