Share via


ConnectionInfo (Windows Embedded CE 6.0)

1/6/2010

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.

Syntax

            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

Header av_upnp.h
Library Av_upnp.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

UPnP AV Structures
DIRECTION
IAVTransport
IConnectionManager::GetCurrentConnectionInfo
IRenderingControl
IVirtualService::Release
wstring class (UPnP AV)