ConnectionInfo (Windows Embedded CE 6.0)

1/6/2010

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

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

See Also

Reference

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