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. |
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 |