IRTCSession::AddStream (Windows CE 5.0)
This method adds one new stream to this session. The session must be in the RTCSS_CONNECTED or RTCSS_INPROGRESS state. The call starts a renegotiation with the other end of the call, and an RTCE_SESSION_STATE_CHANGE event is triggered.
HRESULT AddStream(long lMediaType,LONG_PTR lCookie);
Parameters
lMediaType
[in] An RTCMT_ constant specifying the media for which the stream will be added. The application can add only one stream at a time.Windows CE does not support RTCMT_VIDEO_SEND, RTCMT_VIDEO_RECEIVE and RTCMT_T120_SENDRECV media types.
lCookie
[in] Pointer to an application-provided cookie used in the completion notification.
Return Values
This method can return an RTC_E_ constant.
The following table shows additional information about specific return values.
| Value | Description |
|---|---|
| RTC_E_INVALID_SESSION_STATE | Session must be connected or in progress. |
| RTC_E_INVALID_SESSION_TYPE | Session must be PC-to-PC or PC-to-phone. |
Remarks
This method will add a media type to the list of preferred media types specified in the call to IRTCClient::SetPreferredMediaTypes.
Security Note This method can send media such as audio or video over the network in unencrypted form. Therefore, someone eavesdropping on the network might be able to render the media. Before using this method in an unencrypted session, consider the security risk of sending this media stream.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSession | IRTCClient::SetPreferredMediaTypes | IRTCSession::RemoveStream
Send Feedback on this topic to the authors