Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Note:
This structure contains IAVTransportand IRenderingControlreferences. When control point code is finished with these objects, it must call IVirtualService::Releaseon each reference.

Syntax

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

Members

pRenderingControl

Pointer to an IRenderingControlinstance 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::Releasewhen the object is no longer needed.

pAVTransport

Pointer to an IAVTransportinstance 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::Releasewhen 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 strPeerConnectionManagerand nPeerConnectionIDmembers. 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 strPeerConnectionManagermember, 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
Windows Mobile Windows Mobile Version 5.0 and later

See Also