ConnectionInfo (Windows CE 5.0)

  • Article

Send Feedback

This structure contains information about a single connection maintained by a ConnectionManager instance.

Note   This structure contains IAVTransport and IRenderingControl references. When control point code is finished with these objects, it must call IVirtualService::Release on each reference.

struct ConnectionInfo{  IRenderingControl*  pRenderingControl;  IAVTransport*       pAVTransport;  wstring             strRemoteProtocolInfo;  wstring             strPeerConnectionManager;  long                nPeerConnectionID;  DIRECTION           Direction;  wstring             strStatus;};

Members

  • pRenderingControl
    Pointer to an IRenderingControl instance that represents the RenderingControl service instance associated with this connection. Corresponds to the ConnectionManager A_ARG_TYPE_RcsID state variable. Control points using this pointer must call IVirtualService::Release when the object is no longer needed.
  • pAVTransport
    Pointer to an IAVTransport instance that represents the AVTransport service instance associated with this connection. Corresponds to the ConnectionManager A_ARG_TYPE_AVTransportID state variable. Control points using this pointer must call IVirtualService::Release when the object is no longer needed.
  • strRemoteProtocolInfo
    Comma-separated list of information about the protocols and content formats supported by the ConnectionManager instance represented by the strPeerConnectionManager and nPeerConnectionID members. Corresponds to the ConnectionManager A_ARG_TYPE_ProtocolInfo state variable.
  • strPeerConnectionManager
    UPnP UDN/ServiceID of the ConnectionManager instance to which this connection is made. Can be used with UPnP discovery to retrieve the ConnectionManager instance's device description. Corresponds to the ConnectionManager A_ARG_TYPE_ConnectionManager state variable.
  • nPeerConnectionID
    Connection ID maintained by the peer ConnectionManager instance for this connection. Can be used, after using the strPeerConnectionManager member, to retrieve the remote device's service description. Corresponds to the ConnectionManager A_ARG_TYPE_ConnectionID state variable.
  • Direction
    Whether this connection is outputting or receiving content, represented by DIRECTION. Corresponds to the ConnectionManager A_ARG_TYPE_Direction state variable.
  • strStatus
    The current status of this connection. Corresponds to the ConnectionManager A_ARG_TYPE_ConnectionStatus state variable.

Remarks

You can retrieve connection information for a connection using IConnectionManager::GetCurrentConnectionInfo.

The members of this structure correspond to OUT parameters in the ConnectionManager service's GetCurrentConnectionInfo action.

For more information about the actions and state variables defined by the UPnP AV DCP, 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 Structures | DIRECTION | IAVTransport | IConnectionManager::GetCurrentConnectionInfo | IRenderingControl | IVirtualService::Release | wstring

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.